NPKIFindTrustedRootsInContext

Finds all of the Trusted Root objects within the specified Trusted Root container and returns the number found (formerly NWPKIFindTrustedRootsInContext).

Syntax

    #include "npki.h"
    
    NWRCODE NPKIFindTrustedRootsInContext(
       const NPKIContext       context,
       const unicode          *nameContextDN,
       pnuint32                numberOfTrustedRoots);
    

Parameters

context
(IN) Specifies the NPKI context for the request.
nameContextDN
(IN) Points to the eDirectory FDN of the Trusted Root container that is to be searched.
numberOfTrustedRoots
(OUT) Specifies the number of trusted roots in the trusted root container specified by nameContextDN.

Return Values

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

Remarks

For each root found, a call to NPKIGetTrustedRootInfo can be made to retrieve the relevant information about the root.

Trusted Root containers along with Trusted Root objects provide a method of logically grouping, managing, and accessing X.509 root (or CA) certificates within a directory service.

See Also

NPKICreateTrustedRoot, NPKICreateTrustedRootContainer, NPKIGetTrustedRootInfo