IAlternativeName ::InitializeFromRawData, méthode (certenroll.h)

Article
02/26/2024

La méthode InitializeFromRawData initialise l’objet à partir d’un GUID DSA (Digital Signature Algorithm), d’un nom de répertoire X.500 ou d’une adresse IP (Internet Protocol) contenue dans un tableau d’octets encodé Distinguished Encoding Rules (DER).

Syntaxe

HRESULT InitializeFromRawData(
  [in] AlternativeNameType Type,
  [in] EncodingType        Encoding,
  [in] BSTR                strRawData
);

Paramètres

[in] Type

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

Valeur	Signification
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.

[in] Encoding

Valeur d’énumération EncodingType qui identifie le type d’encodage Unicode appliqué au paramètre strRawData .

[in] strRawData

Variable BSTR qui contient les données encodées en DER.

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. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Code de retour	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L’objet est déjà initialisé.

Remarques

Les données brutes sont un tableau d’octets qui a été encodé à l’aide de Distinguished Encoding Rules (DER). Vous devez spécifier le tableau d’octets sous la forme d’une chaîne encodée Unicode.

Si vous utilisez cette méthode pour spécifier un GUID DSA (XCN_CERT_ALT_NAME_GUID), le GUID est associé au XCN_OID_NTDS_REPLICATION (1.3.6.1.4.1.311.25.1) identificateur d’objet (OID) et encodé en tant que chaîne d’octets (tableau d’octets). Vous pouvez récupérer l’OID en appelant la propriété ObjectId . Vous pouvez appeler la propriété RawData pour récupérer le tableau d’octets encodé.

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_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 nom d’utilisateur principal (UPN).
XCN_CERT_ALT_NAME_OTHER_NAME	Le nom se compose d’un OID et d’un tableau d’octets.

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 InitializeFromString pour spécifier une adresse e-mail, un nom DNS, une URL, un OID inscrit ou un nom d’utilisateur principal (UPN).

Configuration requise

Condition requise	Valeur
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

Partager via