ICertPropertyEnrollment ::Initialize, méthode (certenroll.h)

Article
02/23/2024

La méthode Initialize initialise la propriété à partir de l’ID de demande de certificat, de la chaîne de configuration de l’autorité de certification et d’un nom complet de certificat facultatif.

Syntaxe

HRESULT Initialize(
  [in]           LONG RequestId,
  [in]           BSTR strCADnsName,
  [in]           BSTR strCAName,
  [in, optional] BSTR strFriendlyName
);

Paramètres

[in] RequestId

Variable LONG qui contient l’ID de demande de certificat. Un ID de demande est créé par le processus d’inscription. Vous pouvez récupérer cette valeur en appelant la propriété RequestId sur l’interface IX509Enrollment .

[in] strCADnsName

Variable BSTR qui contient le nom DNS (Domain Name System) de l’autorité de certification. Il s’agit du prénom dans la chaîne de configuration de l’autorité de certification CADnsName\CAName . La chaîne de configuration est généralement définie pendant le processus d’inscription. Le nom DNS peut être récupéré en appelant la propriété CAConfigString et en séparant la chaîne en ses composants.

[in] strCAName

Variable BSTR qui contient le nom commun de l’objet (CN) de l’autorité de certification. Il s’agit du deuxième nom dans la chaîne de configuration de l’autorité de certification CADnsName\CAName . La chaîne de configuration est généralement définie pendant le processus d’inscription. Le nom CN peut être récupéré en appelant la propriété CAConfigString et en séparant la chaîne en ses composants.

[in, optional] strFriendlyName

Variable BSTR qui contient un nom d’affichage facultatif pour le certificat. La valeur par défaut est NULL. Cette valeur est généralement définie pendant le processus d’inscription. Vous pouvez le récupérer en appelant la propriété CertificateFriendlyName .

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/valeur de retour	Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L’objet est déjà initialisé.

Remarques

Les valeurs que vous pouvez utiliser pour initialiser l’objet ICertPropertyEnrollment sont définies pendant le processus d’inscription de certificat lorsque le client appelle la méthode Enrollment sur l’objet IX509Enrollment . Autrement dit, pour récupérer un ID de demande, appelez la propriété RequestId sur l’objet IX509Enrollment . Pour récupérer un nom complet de certificat, appelez la propriété CertificateFriendlyName . Pour récupérer un nom unique et un nom commun, appelez la propriété CAConfigString et séparez la chaîne de configuration en ses composants.

Appelez la méthode SetValueOnCertificate pour associer la propriété à un certificat. Vous pouvez également appeler les propriétés suivantes pour récupérer les valeurs spécifiées lors de l’initialisation :

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

ICertProperty

ICertPropertyEnrollment

Partager via