IX509Enrollment2 ::InitializeFromTemplate, méthode (certenroll.h)

Article
08/22/2023

La méthode InitializeFromTemplate initialise l’objet d’inscription à l’aide d’un modèle.

Syntaxe

HRESULT InitializeFromTemplate(
  [in] X509CertificateEnrollmentContext context,
  [in] IX509EnrollmentPolicyServer      *pPolicyServer,
  [in] IX509CertificateTemplate         *pTemplate
);

Paramètres

[in] context

Valeur d’énumération X509CertificateEnrollmentContext qui indique si l’inscription demandée concerne un utilisateur, un ordinateur ou un administrateur agissant pour le compte d’un ordinateur. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
ContextUser	Le certificat est demandé pour un utilisateur final.
ContextMachine	Le certificat est demandé pour un ordinateur.
ContextAdministratorForceMachine	Le certificat est demandé par un administrateur agissant pour le compte d’un ordinateur.

[in] pPolicyServer

Pointeur vers un objet IX509EnrollmentPolicyServer qui représente le serveur de stratégie d’inscription de certificat (CEP) qui contient le modèle spécifié par le paramètre pTemplate .

[in] pTemplate

Pointeur vers un objet IX509CertificateTemplate qui représente le modèle à utiliser pendant l’initialisation.

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
E_POINTER	Les paramètres pPolicyServer et pTemplate ne peuvent pas être NULL.
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	L’objet d’inscription a déjà été initialisé.

Remarques

Méthode InitializeFromTemplate :

Examine le modèle pour déterminer le type de requête nécessaire.
Crée le type approprié d’objet de requête (PKCS #10, PKCS #7 ou CMC).
Définit les propriétés suivantes sur la demande si des valeurs existent actuellement :
Initialise l’objet de requête à l’aide du modèle .
Récupère le nombre de signatures, les stratégies d’émission et les stratégies d’application à partir du modèle.

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

IX509Enrollment2

Partager via