Syntax

   #include "NPKIT_x509.h"
   
   NWRCODE NPKIT_x509IssuerAltName
   (
      NPKIT_x509Context     context,
      nuint32               index,
      nuint8               *type,
      nuint8 const        **value,
      pnuint32              length,
      unicode const        **name
   );
   

Parameters

context

(IN) Specifies the NPKIT_x509 context handle for the request. This is a nuint32 value.

index

(IN) Specifies which issuer alternative name is to be returned. index is 0 based.

type

(OUT) Points to the type of issuer alternative name. For more information, see Section 4.3, General Name Type Extensions.

value

(OUT) Points to the ASN.1 encoded issuer alternative name.

length

(OUT) Specifies the length of value.

name

(OUT) Points to a Unicode string representation of the issuer alternative name.

NOTE:This field is only set when the issuer alternative name is one of the following extension types:

• X509_GENERAL_NAME_RFC822_NAME
• X509_GENERAL_NAME_DNS_NAME
• X509_GENERAL_NAME_DIRECTORY_NAME

For more details, see Section 4.3, General Name Type Extensions.

Return Values

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. You should call NPKIT_x509IssuerAltNamesInfo before calling this function to determine how many issuer alternative names are encoded in the certificate. For more details about issuer alternative names, see Section 4.3, General Name Type Extensions. The issuer alternative names extension is optional. Therefore, not all certificates have issuer alternative names.

See Also

NPKIT_x509DecodeCertificate, NPKIT_x509IssuerAltNamesInfo, NPKIT_x509SubjectAltName