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

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

La méthode createPFXWStr enregistre la chaîne de certificats et la clé privée acceptées dans une chaîne de format PFX (Personal Information Exchange). Le format PFX est également appelé PKCS #12. Cette méthode a été définie pour la première fois dans l’interface IEnroll4 .

Syntaxe

HRESULT createPFXWStr(
  [in]  LPCWSTR          pwszPassword,
  [out] PCRYPT_DATA_BLOB pblobPFX
);

Paramètres

[in] pwszPassword

Pointeur vers une chaîne Unicode terminée par null qui représente le mot de passe du message au format PFX. Cette valeur peut être vide ou NULL pour indiquer qu’aucun mot de passe n’est utilisé. Lorsque vous avez terminé d’utiliser le mot de passe, supprimez les informations sensibles de la mémoire en appelant SecureZeroMemory. Pour plus d’informations sur la protection du mot de passe, consultez Gestion des mots de passe.

[out] pblobPFX

Pointeur vers la structure CRYPT_DATA_BLOB qui reçoit les informations de certificat au format PFX codé en base64.

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