Partager via


IObjectId ::InitializeFromName, méthode (certenroll.h)

La méthode InitializeFromName initialise l’objet à partir d’une valeur d’énumération CERTENROLL_OBJECTID . Cette méthode est activée sur le web.

Syntaxe

HRESULT InitializeFromName(
  [in] CERTENROLL_OBJECTID Name
);

Paramètres

[in] Name

Valeur d’énumération CERTENROLL_OBJECTID .

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 incluent, mais ne sont pas limitées à celles du tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Retourner le code/la valeur Descriptif
CERTSRV_E_PROPERTY_EMPTY
Les informations OID sont introuvables.
CRYPT_E_UNKNOWN_ALGO
Le nom de l’algorithme n’est pas reconnu.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
L’objet est déjà initialisé.

Remarques

Chaque valeur CERTENROLL_OBJECTID est associée à un identificateur d’objet ASN.1. Par exemple, la valeur XCN_OID_ECDSA_SHA1 est associée à une chaîne qui contient 1.2.840.10045.4.1. Il s’agit de la représentation décimale pointillée de l’identificateur d’objet iso(1)member-body(2)us(840)10045 signatures(4)sha1(1).

La méthode InitializeFromName recherche dans le Registre des informations associées à l’identificateur d’objet ASN.1. Si des informations sont trouvées, la méthode remplit en interne une structure CRYPT_OID_INFO et l’associe à l’objet. La méthode utilise également les informations locales pour initialiser, si possible, le nom complet de l’objet.

Vous pouvez appeler les propriétés suivantes pour récupérer des informations sur un objet IObjectId initialisé :

Spécifications

Requirement Valeur
Client minimum requis Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
plateforme cible Fenêtres
Header certenroll.h
DLL CertEnroll.dll

Voir aussi

FriendlyName

IObjectID