ICertEncodeAltName::GetNameChoice

The GetNameChoice method returns the name choice at a specified index of an alternate name array.

[VB] long GetNameChoice(
  long NameIndex  
);
 
[JAVA] int GetNameChoice(
  int NameIndex               
);
 
[C++] HRESULT GetNameChoice(
  LONG NameIndex,             // in
  LONG *pNameChoice           // out, return value
);
 

Parameters

[VB][JAVA][C++] NameIndex
Specifies the index of the alternate name entry.
[C++] pNameChoice
Points to the return value. See Return Values.

Return Values

Returns the name choice at the specified index. The name choice indicates the type of the alternate name so that it can be used correctly. It must be one of the following values.

Name Choice Specifier Description
CERT_ALT_NAME_RFC822_NAME The name is an e-mail address.
CERT_ALT_NAME_DNS_NAME The name is an IA5 string specifying a DNS (Domain Name System) name in the format host.entity.domain.
CERT_ALT_NAME_URL The name is an IA5 string specifying a URL (Universal Resource Locator) in the format service://hostname/pathname.
CERT_ALT_NAME_REGISTERED_ID The name is a registered OID (Object Identifier).

QuickInfo

  Windows NT: Requires version 5.0 or later (or version 4.0 with the Windows NT 4.0 Option Pack).
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in certenc.h.
  Import Library: Use certidl.lib.