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.

Note

The name of the object must include the full name-space with "Device" as the root node, e.g. "Device.MyObject" or if it's a file system object with "/" as the root node.

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