Partager via


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