Syntax

    #include "npki.h"
    
    NWRCODE NPKIGetTrustedRootInfo(
       const NPKIContext        context,
       nuint32                  index,
       unicode const          **name,
       unicode const          **validFrom,
       unicode const          **validTo,
       unicode const          **subjectName,
       nuit8 const            **certificate,
       pnuint32                 certificateLen);
    

Parameters

context

(IN) Specifies the NPKI context for the request.

index

(IN) Specifies the Trusted Root object for which information is to be returned.

NOTE:index is 0 based.

name

(OUT) Returns the eDirectory FDN of the specified Trusted Root object.

validFrom

(OUT) Returns a Unicode string representation of the starting validity of the X.509 certificate stored in the specified Trusted Root object. Date is in the form YYYMMDDSS.

validTo

(OUT) Returns a Unicode string representation of the ending validity of the X.509 certificate stored in the specified Trusted Root object. Date is in the form YYYMMDDSS.

subjectName

(OUT) Returns a Unicode representation of the subject name of the X.509 certificate stored in the specified Trusted Root object.

certificate

(OUT) Returns the DER-encoded X.509 root (or CA) certificate stored in the specified Trusted Root object.

certificateLen

(OUT) Returns the size of the certificate.

Return Values

Returns 0 if successful, or an eDirectory error code if not successful.

Remarks

You must call NPKIFindTrustedRootsInContext successfully before calling NPKIGetTrustedRootInfo. Trusted Root containers and Trusted Root objects provide a method to logically group, manage and access X.509 root (or certificate authority) certificates within a directory service.

See Also

NPKICreateTrustedRoot, NPKICreateTrustedRootContainer, NPKIFindTrustedRootsInContext