UserMgrObjectGetNextGroup (FUN)

FUNCTION UserMgrObjectGetNextGroup : RTS_IEC_HANDLE

Iteration interface to get the next group in the user rights management of the specified object. Must be started with UserMgrObjectGetFirstGroup()

InOut:

Scope

Name

Type

Comment

Return

UserMgrObjectGetNextGroup

RTS_IEC_HANDLE

Handle to the next group of the object in the user rights management or RTS_INVALID_HANDLE if failed

Input

hUser

RTS_IEC_HANDLE

Handle to authorized user

hObject

RTS_IEC_HANDLE

Handle to the object

hPrevGroup

RTS_IEC_HANDLE

Handle to the previous group retrieved via UserMgrObjectGetFirstGroup() or subsequent calls of UserMgrObjectGetNextGroup()

Output

Result

RTS_IEC_RESULT

Error code
  • ERR_OK: Next group available

  • ERR_PARAMETER: Invalid handles

  • ERR_NO_OBJECT: No next group available

  • ERR_NO_ACCESS_RIGHTS: User not authorized