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

Article
02/23/2024

La méthode SetNameEntry définit un nom à un index spécifié du tableau de noms de remplacement.

Avant d’utiliser cette méthode, vous devez appeler ICertEncodeAltName ::Reset afin que l’objet sache combien d’éléments se trouvent dans le tableau.

Syntaxe

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

Paramètres

[in] NameIndex

Index de base zéro qui spécifie l’index de l’autre entrée de nom à définir.

Si le paramètre NameChoice est CERT_ALT_NAME_OTHER_NAME, OR (|) la valeur d’index avec EAN_NAMEOBJECTID (définie comme 0x80000000) pour définir l’OID. Sinon, la valeur binaire est définie.

[in] NameChoice

Spécifie le nom choisi. Le choix du nom indique le type de l’autre nom afin qu’il puisse être utilisé correctement. Il doit s’agir de l’une des valeurs suivantes.

Valeur	Signification
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 spécifiant un nom DNS (Domain Name System) au format host.entity.domain.
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 identificateur d’objet (OID) et d’un objet BLOB binaire.

[in] strName

Spécifie l’autre nom.

Valeur retournée

VB

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.

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

Partager via