GetNameChoice

Historical Content Alert

This is a historical content for Windows NT 4.0 product and is presented for informative purposes only. All content in this directory is copyrighted and owned by Microsoft.

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).