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

[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