NPKIT_x509IssuerAltNamesInfo

Retrieves the number of issuer alternative names encoded in the certificate if the issuer alternative names extension exists in the certificate (formerly NWx509IssuerAltNamesInfo).

Syntax

   #include "NPKIT_x509.h"
   
   NWRCODE NPKIT_x509IssuerAltNamesInfo
   (
      NPKIT_x509Context      context,
      pnuint32               numIssuerAltNames
   );
   

Parameters

context
(IN) Specifies the NPKIT_x509 context handle for the request. This is a nuint32 value.
numIssuerAltNames
(OUT) Specifies the number of issuer alternative names encoded in the certificate.

Return Values

This routine returns 0 if successful, or a PKI error code if not successful. For a listing of NPKIT error codes, see Certificate Server Error Code Constants.

Remarks

Before calling this function, you must first successfully call NPKIT_x509DecodeCertificate. Iterative calls to NPKIT_x509IssuerAltName can be made to retrieve each of the issuer alternative names. The issuer alternative names extension is optional. Therefore, not all certificates will have Issue Alternative Names.

See Also

NPKIT_x509DecodeCertificate, NPKIT_x509GetExtensionData, NPKIT_x509IssuerAltName