Méthode IAlternativeName::InitializeFromString (certenroll.h)

Article
03/14/2023

La méthode InitializeFromString initialise l’objet à partir d’une chaîne qui contient une adresse e-mail, un nom DNS (Domain Name System), une URL, un identificateur d’objet inscrit (OID) ou un nom d’utilisateur principal (UPN).

Syntaxe

HRESULT InitializeFromString(
  [in] AlternativeNameType Type,
  [in] BSTR                strValue
);

Paramètres

[in] Type

Valeur d’énumération AlternativeNameType qui identifie le type de nom représenté par la chaîne d’entrée contenue dans le paramètre strValue . Il doit s’agir de l’une des valeurs suivantes.

Valeur	Signification
XCN_CERT_ALT_NAME_RFC822_NAME	Le nom est une adresse e-mail.
XCN_CERT_ALT_NAME_DNS_NAME	Le nom est un nom DNS.
XCN_CERT_ALT_NAME_URL	Le nom est une URL.
XCN_CERT_ALT_NAME_REGISTERED_ID	Le nom est un OID inscrit.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Le nom est un UPN.

[in] strValue

Variable BSTR qui contient le nom.

Valeur retournée

Si la fonction réussit, la fonction retourne S_OK.

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

Remarques

Si vous utilisez cette méthode pour spécifier un UPN, l’UPN est associé à l’OID XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.3) et est Distinguished Encoding Rules (DER) encodé. Vous pouvez appeler la propriété RawData pour récupérer le tableau d’octets encodé. Vous pouvez récupérer l’OID en appelant la propriété ObjectId .

Si vous utilisez cette méthode pour spécifier l’un des types de noms suivants, la méthode retourne E_INVALIDARG.

Valeur	Description
XCN_CERT_ALT_NAME_UNKNOWN	Le type de nom n’est pas identifié.
XCN_CERT_ALT_NAME_OTHER_NAME	Le nom se compose d’un OID et d’un tableau d’octets.
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Le nom est un nom de répertoire X.500 .
XCN_CERT_ALT_NAME_IP_ADDRESS	Le nom est une adresse IP.
XCN_CERT_ALT_NAME_GUID	Le nom est un GUID.

Vous pouvez utiliser la méthode InitializeFromOtherName pour spécifier un OID et une chaîne de nom correspondante, et vous pouvez utiliser la méthode InitializeFromRawData pour spécifier un GUID, une adresse IP ou un nom de répertoire X.500.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certenroll.h
DLL	CertEnroll.dll

Voir aussi

IAlternativeName

IAlternativeNames

IX509ExtensionAlternativeNames

Partager via