UserMgrObjectAdd
(FUN)
FUNCTION UserMgrObjectAdd : RTS_IEC_HANDLE
Adds a new object to the user management, so the access rights can be configured on that object.
Limited to the application subtree.
Note
The name of the object must include the full name-space with “Device” as the root node, e.g. “Device.PlcLogic.Application.MyObject”.
- InOut:
Scope
Name
Type
Comment
Return
UserMgrObjectAdd
RTS_IEC_HANDLE
Handle to the object or RTS_INVALID_HANDLE if it could not be added
Input
pszObject
REFERENCE TO STRING
Full object name (see object tree)
pResult
POINTER TO RTS_IEC_RESULT
- Pointer to error code
ERR_OK: Object could be added
ERR_PARAMETER: Object invalid = NULL or empty
ERR_NOTINITIALIZED: The user management is not initialized or it is not loaded yet
ERR_NOMEMORY: If memory could not be allocated to store this object
ERR_NO_ACCESS_RIGHTS: No access rights in IEC context