Méthode ICertEncodeAltName ::SetNameEntry (certenc.h)
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 |
---|---|
|
Le nom est un nom de répertoire. |
|
Le nom est une chaîne IA5 spécifiant un nom DNS (Domain Name System) au format host.entity.domain. |
|
Le nom est une chaîne d’octets qui représente une adresse de protocole Internet. |
|
Le nom est un identificateur d’objet inscrit (OID). |
|
Le nom est une adresse e-mail. |
|
Le nom est une chaîne IA5 qui contient une URL au format Service ://HostName/Path. |
|
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 |