ICertEncodeAltName ::GetName, méthode (certenc.h)

La méthode GetName retourne le nom spécifié à partir du tableau de noms de remplacement.

Syntaxe

HRESULT GetName(
  [in]  LONG NameIndex,
  [out] BSTR *pstrName
);

Paramètres

[in] NameIndex

Index de base zéro qui spécifie l’index de l’autre entrée de nom à récupérer.

Pour récupérer l’identificateur d’objet (OID) d’un nom de CERT_ALT_NAME_OTHER_NAME, combinez la valeur d’index avec EAN_NAMEOBJECTID (définie comme 0x80000000) avec une opération OR au niveau du bit. Sinon, la valeur binaire est récupérée. Pour déterminer le type de nom, appelez la méthode ICertEncodeAltName ::GetNameChoice .

[out] pstrName

Pointeur vers un BSTR qui reçoit l’autre nom. Lorsque vous avez terminé d’utiliser le BSTR, libérez-le en appelant la fonction SysFreeString .

Valeur retournée

C++

Si la méthode réussit, la méthode retourne S_OK.

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 nom de remplacement à l’index spécifié. La valeur de retour est une chaîne Unicode .

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 ::GetNameChoice

ICertEncodeAltName ::SetNameEntry