Méthode IEnroll4 ::createRequestWStr (xenroll.h)

Article
03/06/2024

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

La méthode createRequestWStr crée une demande de certificat au format PKCS #10, PKCS #7 ou gestion complète des certificats sur CMS (CMC) et la stocke dans un objet BLOB. Cette méthode a été définie pour la première fois dans l’interface IEnroll4 .

Syntaxe

HRESULT createRequestWStr(
  [in]  LONG             Flags,
  [in]  LPCWSTR          pwszDNName,
  [in]  LPCWSTR          pwszUsage,
  [out] PCRYPT_DATA_BLOB pblobRequest
);

Paramètres

[in] Flags

Valeur spécifiant le type de demande de certificat à créer. Spécifiez l’une des valeurs suivantes.

Valeur	Signification
XECR_CMC	CMC complet
XECR_PKCS10_V1_5	PKCS #10
XECR_PKCS10_V2_0	PKCS #10 version 2
XECR_PKCS7	PKCS #7

[in] pwszDNName

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le nom unique (DN) de l’entité pour laquelle la demande est effectuée. Le nom du DN doit suivre la convention d’affectation de noms X.500 , par exemple « CN=User, O=Microsoft ». S’il n’existe pas de préfixe à deux lettres, un identificateur d’objet (OID) peut être fourni à la place. Ce paramètre peut être NULL.

[in] pwszUsage

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient l’OID qui décrit l’objectif du certificat généré, 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.

[out] pblobRequest

Pointeur vers une structure CRYPT_DATA_BLOB qui reçoit la requête.

Lorsque vous avez terminé d’utiliser cette mémoire, libérez-la en passant le membre pbData de cette structure à la fonction CoTaskMemFree .

Valeur retournée

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.

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

Voir aussi

IEnroll4