IX509EnrollmentHelper ::Enroll, méthode (certenroll.h)

Article
08/22/2023

La méthode Enroll inscrit une demande de certificat et récupère le certificat émis. Cette méthode est activée sur le web.

Syntaxe

HRESULT Enroll(
  [in]          BSTR               strEnrollmentPolicyServerURI,
  [in]          BSTR               strTemplateName,
  [in]          EncodingType       Encoding,
  [in]          WebEnrollmentFlags enrollFlags,
  [out, retval] BSTR               *pstrCertificate
);

Paramètres

[in] strEnrollmentPolicyServerURI

BSTR qui contient l’URL du serveur de stratégie d’inscription de certificat.

[in] strTemplateName

Variable BSTR qui contient le nom commun (CN) du modèle tel qu’il apparaît dans Active Directory ou l’identificateur d’objet décimal pointillé.

[in] Encoding

Valeur d’énumération EncodingType qui spécifie le type d’encodage appliqué à un tableau d’octets à des fins d’affichage.

[in] enrollFlags

Valeur d’énumération WebEnrollmentFlags qui spécifie le comportement d’inscription web. Il peut s’agir de la valeur suivante.

Valeur	Signification
InscrirePrompt	Si cet indicateur est défini et qu’aucune information d’identification d’authentification n’est disponible pour le serveur d’inscription de certificats, le service de certificats invite à entrer des informations d’identification. S’il n’existe aucune information d’identification d’authentification et que cet indicateur n’est pas défini, la méthode Enroll échoue.

[out, retval] pstrCertificate

BSTR qui contient le certificat émis.

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
E_INVALIDARG	Les paramètres strEnrollmentPolicyServerURI et strTemplateName ne peuvent pas être NULL.
HRESULT_FROM_WIN32(ERROR_ARITHMETIC_OVERFLOW)	Les paramètres strEnrollmentPolicyServerURI et strTemplateName dépassent 64 000 caractères ou contiennent des caractères Null incorporés.

Remarques

La méthode Enroll récupère le modèle approprié, appelle InitializeFromTemplate, puis appelle Enroll sur l’objet IX509Enrollment .

Cette méthode n’a pas installé le certificat émis.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certenroll.h

Voir aussi

IX509EnrollmentHelper

Partager via