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