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

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 parties constituantes.

[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 parties constituantes.

[in, optional] strFriendlyName

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

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 requête, 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 dans ses parties constituantes.

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 :

• CADnsName
• CAName
• FriendlyName
• RequestId

Spécifications

Voir aussi

ICertProperty

ICertPropertyEnrollment