Méthode IAlternativeName::InitializeFromString (certenroll.h)
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.
[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 |