UserMgrGroupGetName (FUN) ¶ FUNCTION UserMgrGroupGetName : RTS_IEC_RESULT Get group name InOut: Scope Name Type Comment Return UserMgrGroupGetName RTS_IEC_RESULT Error code ERR_OK: Group name is returned ERR_PARAMETER: Invalid group handle ERR_BUFFERSIZE: The buffer was too small ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user hGroup RTS_IEC_HANDLE Handle to the group Inout pszGroup STRING(59) Buffer to store the name, 59 chars max

UserMgrGroupGetNext (FUN) ¶ FUNCTION UserMgrGroupGetNext : RTS_IEC_HANDLE Iteration interface to get next user group. Must be started with UserMgrGroupGetFirst() InOut: Scope Name Type Comment Return UserMgrGroupGetNext RTS_IEC_HANDLE Handle to the next user group or RTS_INVALID_HANDLE if failed Input hUser RTS_IEC_HANDLE Handle to authorized user hPrevGroup RTS_IEC_HANDLE Handle to the previous user group retrieved via UserMgrGroupGetFirst() or subsequent calls of UserMgrGroupGetNext() Output Result RTS_IEC_RESULT Error code ERR_OK: Next user group available ERR_NO_OBJECT: No next user group available ERR_NO_ACCESS_RIGHTS: User not authorized

UserMgrGroupGetNextUser (FUN) ¶ FUNCTION UserMgrGroupGetNextUser : RTS_IEC_RESULT Iteration interface to get next configured user of the user group. Must be started with UserMgrGroupGetFirstUser() InOut: Scope Name Type Comment Return UserMgrGroupGetNextUser RTS_IEC_RESULT Error code ERR_OK: Next user available ERR_NO_OBJECT: No next user available ERR_PARAMETER: Invalid iterator handle ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user hGroup RTS_IEC_HANDLE Group handle Inout phIterator RTS_IEC_HANDLE Iteration handle to use with next call to UserMgrGroupGetNextUser() pszUsername STRING(59) Buffer to store the name, 59 chars max

UserMgrGroupRemove (FUN) ¶ FUNCTION UserMgrGroupRemove : RTS_IEC_RESULT Remove a group from user group database InOut: Scope Name Type Comment Return UserMgrGroupRemove RTS_IEC_RESULT Error code ERR_OK: Group was successfully removed ERR_NO_OBJECT: Group name does not exist ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user Inout Const pszGroupName STRING Name of the group

UserMgrGroupRemoveUser (FUN) ¶ FUNCTION UserMgrGroupRemoveUser : RTS_IEC_RESULT Remove user from a group in the user group database InOut: Scope Name Type Comment Return UserMgrGroupRemoveUser RTS_IEC_RESULT Error code ERR_OK: User could be removed ERR_NO_OBJECT: Group or user name does not exist ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user Inout Const pszGroup STRING Group name pszUser STRING User name

Objecthandling ¶ UserMgrObjectAdd (Function) UserMgrObjectAddGroup (Function) UserMgrObjectClearRights (Function) UserMgrObjectGetFirstChild (Function) UserMgrObjectGetFirstGroup (Function) UserMgrObjectGetGroupRights (Function) UserMgrObjectGetHandle (Function) UserMgrObjectGetName (Function) UserMgrObjectGetNextChild (Function) UserMgrObjectGetNextGroup (Function) UserMgrObjectRemove (Function) UserMgrObjectRemoveGroup (Function) UserMgrObjectSetGroupDeniedRights (Function) UserMgrObjectSetGroupRights (Function) UserMgrObjectSetUsedRights (Function)

TraceMgrPacketStart (FUN) ¶ FUNCTION TraceMgrPacketStart : RTS_IEC_RESULT Starts a trace packet and resets the trigger. Note if the packet is started for the first time, the start time of the packet is set to the current time. See: TraceMgrPacketGetStartTime . InOut: Scope Name Type Comment Return TraceMgrPacketStart RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle Input hPacket RTS_IEC_HANDLE The trace packet handle (in)

TraceMgrPacketStop (FUN) ¶ FUNCTION TraceMgrPacketStop : RTS_IEC_RESULT Stops a trace packet. InOut: Scope Name Type Comment Return TraceMgrPacketStop RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle Input hPacket RTS_IEC_HANDLE The trace packet handle

TraceMgrPacketStore (FUN) ¶ FUNCTION TraceMgrPacketStore : RTS_IEC_RESULT Stores a trace packet to a trace file. Both the trace configuration and the current trace values are stored. InOut: Scope Name Type Comment Return TraceMgrPacketStore RTS_IEC_RESULT Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid handle, or if pszFileName is not a valid file path ERR_NOMEMORY if the memory is not sufficient for opening the file ERR_NOT_SUPPORTED if writing to files is not supported by the runtime system ERR_NO_OBJECT if opening the file failed ERR_FAILED if creating or writing to the file failed Input hPacket RTS_IEC_HANDLE The trace packet handle Inout Const pszFileName STRING The file path

TraceMgrRecordAdd (FUN) ¶ FUNCTION TraceMgrRecordAdd : RTS_IEC_HANDLE Adds a new record to a trace packet InOut: Scope Name Type Comment Return TraceMgrRecordAdd RTS_IEC_HANDLE Returns the runtime system error code (see CmpErrors.library): ERR_PARAMETER if hPacket is not a valid packet handle, if the variable name is not set, or if the variable type is not supported ERR_NOMEMORY if there is not enough free memory to create the record Input hPacket RTS_IEC_HANDLE The trace packet handle Inout pConfiguration TraceRecordConfiguration The record configuration (in) pResult RTS_IEC_RESULT The result code (out)