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 |