UtilityFunctions ¶ RtsOIDClear (Function) RtsOIDCreate (Function) RtsOIDGetID (Function) RtsOIDGetName (Function) X509CertInfoExit (Function) X509CertInfoInit (Function)

RtsOIDClear (FUN) ¶ FUNCTION RtsOIDClear : RTS_IEC_RESULT Clear an OID InOut: Scope Name Type Comment Return RtsOIDClear RTS_IEC_RESULT Result of the operation Input oid POINTER TO RtsOID

RtsOIDCreate (FUN) ¶ FUNCTION RtsOIDCreate : RTS_IEC_RESULT Create an RtsOID based on a given ID. InOut: Scope Name Type Comment Return RtsOIDCreate RTS_IEC_RESULT Result of the operation. Input id POINTER TO STRING OID as string in dottet format. E.g. (1.2.3.4.5.6.7.8.9.0) oid POINTER TO RtsOID Pointer to an OID to fill up.

RtsOIDGetID (FUN) ¶ FUNCTION RtsOIDGetID : RTS_IEC_RESULT Get the ID of an OID in dottet notation. InOut: Scope Name Type Comment Return RtsOIDGetID RTS_IEC_RESULT Result of the operation Input oid POINTER TO RtsOID OID to print. pBuffer POINTER TO RtsByteString Buffer where to store the ID.

RtsOIDGetName (FUN) ¶ FUNCTION RtsOIDGetName : RTS_IEC_RESULT Get the given name of an OID. If the OID is unknown to the system the dottet notation will be returned. InOut: Scope Name Type Comment Return RtsOIDGetName RTS_IEC_RESULT Result of the operation. Input oid POINTER TO RtsOID pBuffer POINTER TO RtsByteString

X509CertHasExtendedKeyUsage (FUN) ¶ FUNCTION X509CertHasExtendedKeyUsage : BOOL Check if the extended keyusages of the specified certificate has the specified extended keyusages InOut: Scope Name Type Comment Return X509CertHasExtendedKeyUsage BOOL True if all key usages are part of the certificate. Input hCert RTS_IEC_HANDLE Handle of to certificate. numOfExKeyUsages UDINT Number of extended keyusages pExKeyUsages POINTER TO RtsOID Pointer to list of extended keyusages pResult POINTER TO RTS_IEC_RESULT POINTER TO error code

X509CertHasKeyUsage (FUN) ¶ FUNCTION X509CertHasKeyUsage : BOOL Check if the specified key-usages are defined within the certificate. InOut: Scope Name Type Comment Return X509CertHasKeyUsage BOOL True if all key usages are part of the certificate. Input hCert RTS_IEC_HANDLE Handle of to certificate. keyUsage UDINT Key usages to check. Refer to Key Usage flags. pResult POINTER TO RTS_IEC_RESULT POINTER TO error code

X509CertIsAuthority (FUN) ¶ FUNCTION X509CertIsAuthority : BOOL Check if the given certificate is certificate autority. Typically this is indicated by the corresponding key usage. Some older ca certificates may be identified by other means. InOut: Scope Name Type Comment Return X509CertIsAuthority BOOL Input hCert RTS_IEC_HANDLE Handle of to certificate. pResult POINTER TO RTS_IEC_RESULT Pointer to error code. ERR_OK if everything went fine, ERR_PARAMETER if hCert was invalid. Output pathLen DINT The maximum path length of the CA. -1 if there is no limit. Only valid, if the function returned TRUE

X509CertIsDateValid (FUN) ¶ FUNCTION X509CertIsDateValid : BOOL Check if a certificate has a valid date (notbefore and notafter is in the current time period) InOut: Scope Name Type Comment Return X509CertIsDateValid BOOL True if the certificate date is valid Input hCert RTS_IEC_HANDLE Handle of to certificate. pResult POINTER TO RTS_IEC_RESULT Pointer to error code. ERR_OK: Everything went fine, ERR_PARAMETER: hCert was invalid

X509CertIsSelfSigned (FUN) ¶ FUNCTION X509CertIsSelfSigned : BOOL Check if a certificate is selfsigned of is signed by a CA authority InOut: Scope Name Type Comment Return X509CertIsSelfSigned BOOL True if the certificate is self signed, False if the certificate is signed by a CA. Input hCert RTS_IEC_HANDLE Handle of to certificate. pResult POINTER TO RTS_IEC_RESULT Pointer to error code. ERR_OK if everything went fine, ERR_PARAMETER if hCert was invalid.