Syntax

    #include "npki.h"
    
    NWRCODE NPKIUserCertInfo(
       const NPKIContext    context, 
       const nuint32        index,
       unicode const      **nickName,
       pnuint32             certSize,
       nuint8 const       **cert,
       pnuint32             certStatus,
       pnuint32             certChainSize,
       nuint8 const       **certChain,
       pnuint32             vendorID, 
       void                *reserved1,
       void                 *reserved2); 
    

Parameters

context

(IN) Specifies the NPKI context for the request.

index

(IN) Specifies which certificate is to be returned.

NOTE:index is 0 based.

nickName

(OUT) Returns the certificate nickname. This name is used to identify the key pair and associated certificate. This name must be unique for the specified user.

certSize

(OUT) Returns size of the specified certificate.

cert

(OUT) Returns the specified DER-encoded X.509 certificate.

certStatus

(OUT) Returns status of the certificate.

certChainSize

(OUT) Not implemented in this release.

certChain

(OUT) Not implemented in this release.

vendorID

(OUT) Returns vendor ID associated with the certificate.

reserved1

Reserved for future use.

reserved2

Reserved for future use.

Return Values

Returns 0 if successful, or a PKI error code if not successful.

Remarks

You must call either NPKICreateUserCertificate or NPKIFindUserCertificates successfully immediately before calling this function.

See Also

NPKICreateUserCertificate, NPKIFindUserCertificates