Partager via

Méthode ICertEncodeAltName ::GetNameChoice (certenc.h)

  • Article

La méthode GetNameChoice retourne le choix de nom à un index spécifié d’un autre tableau de noms.

Syntaxe

HRESULT GetNameChoice(
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

Paramètres

[in] NameIndex

Spécifie l’index de l’entrée de nom de remplacement. La première entrée est à l’index zéro.

[out] pNameChoice

Pointeur vers un LONG qui reçoit le spécificateur de choix de nom.

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK, et le paramètre pNameChoice pointe vers une valeur qui indique le type du nom de remplacement. Il s’agit de l’une des valeurs suivantes.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

VB

La valeur de retour est le choix du nom à l’index spécifié. Le choix du nom indique le type du nom de remplacement afin qu’il puisse être utilisé correctement. Il doit s’agir de l’une des valeurs suivantes.
Code de retour Description
CERT_ALT_NAME_DIRECTORY_NAME
 Le nom est un nom de répertoire.
CERT_ALT_NAME_DNS_NAME
 Le nom est une chaîne IA5 qui contient un nom DNS (Domain Name System) au format Host.Entité.Domaine.
CERT_ALT_NAME_IP_ADDRESS
 Le nom est une chaîne d’octets qui représente une adresse de protocole Internet.
CERT_ALT_NAME_REGISTERED_ID
 Le nom est un identificateur d’objet inscrit (OID).
CERT_ALT_NAME_RFC822_NAME
 Le nom est une adresse e-mail.
CERT_ALT_NAME_URL
 Le nom est une chaîne IA5 qui contient une URL au format Service ://HostName/Path.
CERT_ALT_NAME_OTHER_NAME
 Le nom se compose d’un OID et d’un objet BLOB binaire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête certenc.h (include Certsrv.h)
Bibliothèque Certidl.lib
DLL Certenc.dll

Voir aussi

ICertEncodeAltName

ICertEncodeAltName ::GetName

ICertEncodeAltName ::SetNameEntry