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