ICEnroll4 ::createFileRequest, méthode (xenroll.h)

Article
03/04/2024

[Cette méthode n’est plus disponible à partir de Windows Server 2008 et Windows Vista.]

La méthode createFileRequest crée une demande de certificat PKCS #10, une requête PKCS #7 ou une demande complète de gestion des certificats sur CMS (CMC) et la stocke dans un fichier. Cette méthode a d’abord été définie dans l’interface ICEnroll4 .

Syntaxe

HRESULT createFileRequest(
  [in] LONG Flags,
  [in] BSTR strDNName,
  [in] BSTR strUsage,
  [in] BSTR strRequestFileName
);

Paramètres

[in] Flags

Valeur qui spécifie le type de certificat à créer. Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
XECR_CMC	Console CMC complète
XECR_PKCS10_V1_5	PKCS 10
XECR_PKCS10_V2_0	PKCS 10 version 2
XECR_PKCS7	PKCS 7

[in] strDNName

Ce paramètre peut être NULL ; sinon, ce paramètre spécifie le nom unique (DN) de l’entité pour laquelle la demande est effectuée. Le nom du DN doit respecter la convention de nommage X.500 , par exemple « CN=User, O=Microsoft ». S’il n’existe pas de préfixe à deux lettres, un OID peut être fourni à la place.

[in] strUsage

Identificateur d’objet (OID) qui décrit l’objectif de la demande en cours de génération, par exemple, un certificat Authenticode individuel ou commercial ou l’authentification du client. Vous pouvez également spécifier plusieurs OID séparés par une virgule.

[in] strRequestFileName

Nom du fichier qui recevra la demande.

Valeur retournée

VB

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Lorsque cette méthode est appelée à partir d’un script, la méthode affiche une interface utilisateur qui demande si l’utilisateur autorise la création d’une demande de certificat et si l’utilisateur autorise une opération d’écriture dans le système de fichiers.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xenroll.h
Bibliothèque	Uuid.lib
DLL	Xenroll.dll

Partager via