CERT_ALT_NAME_ENTRY structure (wincrypt.h)

The CERT_ALT_NAME_ENTRY structure contains an alternative name in one of a variety of name forms. These names are bound by a certification authority (CA) to a certificate's public key.

A structure can be CERT_ALT_NAME_ENTRY member of a CERT_ALT_NAME_INFO structure.

Syntax

typedef struct _CERT_ALT_NAME_ENTRY {
  DWORD dwAltNameChoice;
  union {
    PCERT_OTHER_NAME pOtherName;
    LPWSTR           pwszRfc822Name;
    LPWSTR           pwszDNSName;
    CERT_NAME_BLOB   DirectoryName;
    LPWSTR           pwszURL;
    CRYPT_DATA_BLOB  IPAddress;
    LPSTR            pszRegisteredID;
  } DUMMYUNIONNAME;
} CERT_ALT_NAME_ENTRY, *PCERT_ALT_NAME_ENTRY;

Members

dwAltNameChoice

Indicates the union variant used for the alternative name.

This can be one of the following values:

• CERT_ALT_NAME_OTHER_NAME
• CERT_ALT_NAME_RFC822_NAME
• CERT_ALT_NAME_DNS_NAME
• CERT_ALT_NAME_DIRECTORY_NAME
• CERT_ALT_NAME_URL
• CERT_ALT_NAME_IP_ADDRESS
• CERT_ALT_NAME_REGISTERED_ID

DUMMYUNIONNAME

DUMMYUNIONNAME.pOtherName

A pointer to a CERT_OTHER_NAME structure, which includes an object identifier (OID) and a BLOB containing the name.

DUMMYUNIONNAME.pwszRfc822Name

Email address as a Unicode string.

DUMMYUNIONNAME.pwszDNSName

DNS name as an IA5 string.

DUMMYUNIONNAME.DirectoryName

A BLOB structure that contains a directory name.

DUMMYUNIONNAME.pwszURL

URL as a IA5 string.

DUMMYUNIONNAME.IPAddress

Octet string that is an Internet Protocol address defined in accordance with Internet RFC 791.

DUMMYUNIONNAME.pszRegisteredID

Object identifier (OID) of any registered object.

Requirements

See also

CERT_ALT_NAME_INFO

CRYPT_ATTRIBUTE_TYPE_VALUE

CRYPT_INTEGER_BLOB