NPKIGetHostServerDN

Gets the DN of the server that is associated with the specified object (that is, reads the eDirectory attribute A_HOST_SERVER of objectDN) (formerly NWPKIGetHostServerDN).

Syntax

    #include "npki.h"
    
    NWRCODE NPKIGetHostServerDN(
       const NPKIContext    context,
       const unicode       *objectDN,   
       unicode const      **serverDN);

Parameters

context
(IN) Specifies the NPKI context for the request.
objectDN
(IN) Specifies the FDN of the object to read. This must be a valid eDirectory object name.
serverDN
(OUT) Returns the host server’s FDN. This is a valid eDirectory object name.

Return Values

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

Remarks

The eDirectory A_HOST_SERVER attribute is used on PKI and Secure Authentication Services (SAS) objects to identify which server hosts the object (or service).

See Also

NPKICreateServerCertificate, NPKIFindOrganizationalCA, NPKIGetServerInfo, NPKIUserCertInfo