Structs ¶ RtsOID (Struct) RtsX509AltName (Struct) RtsX509CertFilter (Struct) RtsX509CertInfo (Struct) RtsX509CertName (Struct) RtsX509ExKeyUsage (Struct) RtsX509NameEntry (Struct)

RtsOID (STRUCT) ¶ TYPE RtsOID : STRUCT InOut: Name Type Comment length UDINT Lenght of the OID in memory data RtsOIDStore Storage of the OID flags UDINT Internal

RtsX509AltName (STRUCT) ¶ TYPE RtsX509AltName : STRUCT Represents an alternative name of a certificate. The alternative name can be selected out of different meanings. E.g. E-Mail address, IP-Address, URI or a DNS name. Use the corresponding fiels of the union to geht the values. The meaning is declared in the valueType field. InOut: Name Type Comment valueType RtsX509AltNameType Type of the alternative name value RtsX509AltNameStore

RtsX509CertFilter (STRUCT) ¶ TYPE RtsX509CertFilter : STRUCT InOut: Name Type filterType RtsX509CertFilterType filterContent RtsX509CertFilterContent

RtsX509CertInfo (STRUCT) ¶ TYPE RtsX509CertInfo : STRUCT This structuer contains common fiels of an certificate. Most values are stored in textual form if available. The alternative key usages and the signature algorithm are stored as RtsOID. Use the RtsOIDGetName function to get human readable names of this fields. The notBefore and notAfter fields are in UTC format and high resolution timestamp. InOut: Name Type Comment ui32StructSize UDINT Structure size. Used if the structuer is extended in the futuer. issuer RtsX509CertName Common fields of the issuer subject RtsX509CertName Common fields of the subject numOfAltNames UDINT Number of stored alternative names pAltNames POINTER TO RtsX509AltName Pointer to a list of alternative names. notBefore ULINT High resolution UTC timestamp notAfter ULINT High resolution UTC timestamp keyUsage UDINT Key usage field. Use the constans of X509CertKeyUsage to determin the key usages. Every value is represented by a specific bit of the value. numOfExKeyUsages UDINT Number of extended key usages pExKeyUsages POINTER TO RtsOID Pointer to a list of extended key usages. signatureAlgorithm RtsOID OID of the signature algorithm. Use the RtsOIDGetName to get a human readable string.

RtsX509CertName (STRUCT) ¶ TYPE RtsX509CertName : STRUCT InOut: Name Type Comment numOfEntries UDINT Number of entries in the X509 Name entries POINTER TO RtsX509NameEntry Pointer to a list of name entries.

RtsX509ExKeyUsage (STRUCT) ¶ TYPE RtsX509ExKeyUsage : STRUCT InOut: Name Type Comment numOfExKeyUsages UDINT Number of extended key usages pExKeyUsages POINTER TO RtsOID Pointer to a list of extended key usages.

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

UserMgrObjectAddGroup (FUN) ¶ FUNCTION UserMgrObjectAddGroup : RTS_IEC_RESULT Add a group to the specified object to manage access rights InOut: Scope Name Type Comment Return UserMgrObjectAddGroup RTS_IEC_RESULT Error code ERR_OK: Group could be added or is already added ERR_PARAMETER: Invalid handles ERR_NOMEMORY: No memory to add group ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user hObject RTS_IEC_HANDLE Handle to the object hGroup RTS_IEC_HANDLE Handle to the group that should be attached

UserMgrObjectClearRights (FUN) ¶ FUNCTION UserMgrObjectClearRights : RTS_IEC_RESULT This function clears all granted and denied rights for all groups on that object. InOut: Scope Name Type Comment Return UserMgrObjectClearRights RTS_IEC_RESULT Error code ERR_OK: Access rights could be cleared ERR_PARAMETER: Invalid handles ERR_NO_ACCESS_RIGHTS: User not authorized Input hUser RTS_IEC_HANDLE Handle to authorized user hObject RTS_IEC_HANDLE Handle to the object