MÉTHODE IX509CertificateRequestPkcs7 ::InitializeFromTemplateName (certenroll.h)

La méthode InitializeFromTemplateName initialise la demande de certificat à l’aide d’un modèle.

Syntaxe

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

Paramètres

[in] Context

Valeur d’énumération X509CertificateEnrollmentContext qui spécifie si le certificat demandé est destiné à un utilisateur final, un ordinateur ou un administrateur agissant pour le compte de l’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
ERROR_ALREADY_INITIALIZED	L’objet de demande de certificat a déjà été initialisé.

Remarques

La méthode InitializeFromTemplateName crée un objet de requête PKCS #7 et définit les propriétés suivantes sur les valeurs qui existaient avant l’appel de cette méthode :

• CspInformations
• ParentWindow
• Silencieux
• UIContextMessage

La méthode crée les collections suivantes :

• Collection ICryptAttributes .
• Collection IX509Extensions .
• Collection IObjectIds remplie avec les identificateurs d’objet XCN_OID_BASIC_CONSTRAINTS2 et XCN_OID_KEY_USAGE par défaut.
• Collection IObjectIds vide pour les OID d’attribut et d’extension à supprimer de la nouvelle requête.

La méthode examine ensuite le modèle et effectue les actions suivantes :

• Ajoute les extensions spécifiées par le modèle à la collection IX509Extensions .
• Supprime les extensions critiques par défaut (XCN_OID_KEY_USAGE et XCN_OID_BASIC_CONSTRAINTS2) de la collection si le modèle indique qu’elles ne sont pas critiques. Les OID marqués comme critiques par le modèle sont ajoutés.
• Définit la propriété SmimeCapabilities si le modèle prend en charge les algorithmes symétriques.
• Définit la propriété AlternateSignatureAlgorithm si le modèle nécessite un OID d’algorithme de signature discrète.
• Crée un objet IX509SignatureInformation .
• Crée un OID d’algorithme de hachage si l’algorithme est spécifié dans le modèle et le définit sur l’objet IX509SignatureInformation .
• Crée un OID d’algorithme de chiffrement asymétrique si l’algorithme est spécifié dans le modèle et le définit sur l’objet IX509SignatureInformation .
• Définit les propriétés IX509PrivateKey suivantes à partir des paramètres du modèle :
  • KeySpec
  • KeyUsage
  • Durée
  • ExportPolicy
  • KeyProtection
  • SecurityDescriptor
  • Silencieux
  • MachineContext
  • Algorithme

Si la propriété CSPInformations a la valeur NULL, la méthode crée une collection ICspInformations à partir des fournisseurs installés sur l’ordinateur.

Enfin, la méthode définit la requête PKCS #10 initialisée en tant qu’objet de requête interne.

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

IX509CertificateRequestPkcs7