UserMgrObjectGetNextChild (FUN)ΒΆ

FUNCTION UserMgrObjectGetNextChild : RTS_IEC_HANDLE

Iteration interface to get the next child object in the object tree of the specified father object. Must be started with UserMgrObjectGetFirstChild()
Limited to the application subtree.
InOut:

Scope

Name

Type

Comment

Return

UserMgrObjectGetNextChild

RTS_IEC_HANDLE

Handle to the next child object or RTS_INVALID_HANDLE if failed

Input

hFatherObject

RTS_IEC_HANDLE

Handle to the father object

hPrevChild

RTS_IEC_HANDLE

Handle to the previous child object retrieved by UserMgrObjectGetFirstChild() or subsequent calls of UserMgrObjectGetNextChild()

Output

Result

RTS_IEC_RESULT
Error code

  • ERR_OK: Next child object available

  • ERR_PARAMETER: Invalid parameter hFatherObject or hPrevChildObject

  • ERR_NOTINITIALIZED: The user management is not initialized or it is not loaded yet

  • ERR_NO_ACCESS_RIGHTS: No access rights in IEC context