NET_DVR_GetAlarmDeviceUser

Get device user parameters of security control panels.

API Definition

BOOL NET_DVR_GetAlarmDeviceUser(
  LONG                        lUserID,
  LONG                        lUserIndex,
  NET_DVR_ALARM_DEVICE_USER   *lpDeviceUser
);

Parameters

lUserID

[IN] Value returned by NET_DVR_Login_V40.

lUserIndex

[IN] Device user index of security control panels.

lpDeviceUser

[OUT] Device user configuration, which is a pointer pointing to NET_DVR_ALARM_DEVICE_USER.

Return Values

Return TRUE for success, and return FALSE for failure.

If FALSE is returned, you can call NET_DVR_GetLastError to get the error code.

Remarks

  • For security control panels, the device users refer to those log in to the device remotely via SDK, and the operation users refer to those perform operations on the device locally (for example, perform operations on the security control panel by using keypad).

  • The device users (also referred to as network users) include admin users, administrators, and normal users. The maximum number of users and their permission can be obtained by calling the API NET_DVR_GetDeviceAbility (dwAbilityType: DEVICE_USER_ABILITY; related node: <AlarmhostPermission>).

    • Admin users: By default the first user of the device is the admin user which is also a kind of administrators but has more permission than normal administrators. There is only one admin user for a device. The admin user can set or modify the permission of normal users and view all users' information. The admin user's permission cannot be modified.

    • Administrators: For video security control panels, the administrators have all permission of the admin user except restoring to default settings, formatting HDD, upgrading the system program, and restarting. For other security control panels, the administrators can have all permission of the admin user. The permission of administrators cannot be modified by any users (including the admin user). Administrators can view information of normal users and themselves (that is, they cannot view information of the admin user and other administrators), and set or modify permission of normal users (they cannot modify permission of themselves).

    • Normal users: By default they have permission of getting parameters. Other permission should be configured to take effect. The highest available permission level of normal users is that of administrators. Normal users can view information of themselves, but they cannot modify permission of themselves or view information of the admin user, administrators, and other normal users.