IX509Enrollment ::InitializeFromTemplateName, méthode (certenroll.h)

Article
02/26/2024

La méthode InitializeFromTemplateName initialise l’objet d’inscription à partir d’un nom commun de modèle (CN).

Syntaxe

HRESULT InitializeFromTemplateName(
  [in] X509CertificateEnrollmentContext Context,
  [in] BSTR                             strTemplateName
);

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.

[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 en pointillés.

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 d’inscription a déjà été initialisé.

Remarques

Méthode InitializeFromTemplateName :

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 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

IX509Enrollment

Partager via