Partager via

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

  • Article

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