Edit

CERT_ALT_NAME_ENTRY structure (wincrypt.h)

  • Article

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

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header wincrypt.h

See also

CERT_ALT_NAME_INFO

CRYPT_ATTRIBUTE_TYPE_VALUE

CRYPT_INTEGER_BLOB