CERT_ALT_NAME_ENTRY (Compact 2013)

3/28/2014

This structure contains an alternative name in one of a variety of name forms. The certification authority (CA) binds these names to the certificate's public key.

A CERT_ALT_NAME_ENTRY structure can be a 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;
  }; 
} CERT_ALT_NAME_ENTRY, *PCERT_ALT_NAME_ENTRY;

Members

• dwAltNameChoice
  The union variant used for the alternative name.

  This member can be set to the following values:

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

• pOtherName
  Pointer to a CERT_OTHER_NAME structure, which includes an OID and a BLOB (Cryptography) structure containing the name.

• pwszRfc822Name
  E-mail address as a Unicode string.

• pwszDNSName
  DNS name as an IA5 string.

• x400Address
  Not currently implemented.

• DirectoryName
  BLOB structure containing a directory name.

• pEdiPartyName
  Not currently implemented.

• pwszURL
  URL as a IA5 string.

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

• pszRegisteredID
  Object identifier (OID) of any registered object.

Requirements

Header

wincrypt.h

See Also

Reference

Cryptography Structures
BLOB (Cryptography)
CERT_ALT_NAME_INFO