Partager via

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

  • Article

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