Skip to content

Latest commit

 

History

History
170 lines (141 loc) · 4.76 KB

nf-certenc-icertencodealtname-getnamechoice.md

File metadata and controls

170 lines (141 loc) · 4.76 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:certenc.ICertEncodeAltName.GetNameChoice
ICertEncodeAltName::GetNameChoice (certenc.h)
Returns the name choice at a specified index of an alternate name array.
CCertEncodeAltName object [Security]
GetNameChoice method
GetNameChoice
GetNameChoice method [Security]
GetNameChoice method [Security]
CCertEncodeAltName object
GetNameChoice method [Security]
ICertEncodeAltName interface
ICertEncodeAltName interface [Security]
GetNameChoice method
ICertEncodeAltName.GetNameChoice
ICertEncodeAltName::GetNameChoice
_certsrv_icertencodealtname_getnamechoice
certenc/ICertEncodeAltName::GetNameChoice
security.icertencodealtname_getnamechoice
security\icertencodealtname_getnamechoice.htm
security
3b21fbc7-cba1-49b1-bad6-232f717e3056
12/05/2018
CCertEncodeAltName object [Security],GetNameChoice method, GetNameChoice, GetNameChoice method [Security], GetNameChoice method [Security],CCertEncodeAltName object, GetNameChoice method [Security],ICertEncodeAltName interface, ICertEncodeAltName interface [Security],GetNameChoice method, ICertEncodeAltName.GetNameChoice, ICertEncodeAltName::GetNameChoice, _certsrv_icertencodealtname_getnamechoice, certenc/ICertEncodeAltName::GetNameChoice, security.icertencodealtname_getnamechoice
certenc.h
Certsrv.h
Windows
None supported
Windows Server 2003 [desktop apps only]
Certidl.lib
Certenc.dll
Windows
19H1
ICertEncodeAltName::GetNameChoice
certenc/ICertEncodeAltName::GetNameChoice
c++
APIRef
kbSyntax
COM
Certenc.dll
ICertEncodeAltName.GetNameChoice
CCertEncodeAltName.GetNameChoice

ICertEncodeAltName::GetNameChoice

-description

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

-parameters

-param NameIndex [in]

Specifies the index of the alternate name entry. The first entry is at index zero.

-param pNameChoice [out]

A pointer to a LONG that receives the name choice specifier.

-returns

C++

If the method succeeds, the method returns S_OK, and the pNameChoice parameter points to a value that indicates the type of the alternate name. This is one of the following values.

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

VB

The return value is 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.
Return code Description
CERT_ALT_NAME_DIRECTORY_NAME
 The name is a directory name.
CERT_ALT_NAME_DNS_NAME
 The name is an IA5 string that contains a DNS (Domain Name System) name in the format Host.Entity.Domain.
CERT_ALT_NAME_IP_ADDRESS
 The name is an octet string that represents an Internet protocol address.
CERT_ALT_NAME_REGISTERED_ID
 The name is a registered object identifier (OID).
CERT_ALT_NAME_RFC822_NAME
 The name is an email address.
CERT_ALT_NAME_URL
 The name is an IA5 string that contains a URL in the format Service://HostName/Path.
CERT_ALT_NAME_OTHER_NAME
 The name consists of an OID and a binary BLOB.

-see-also

ICertEncodeAltName

ICertEncodeAltName::GetName

ICertEncodeAltName::SetNameEntry