IcEnroll4::createPFX, méthode (xenroll.h)

Article
08/28/2023

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

La méthode createPFX 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 ICEnroll4 .

Syntaxe

HRESULT createPFX(
  [in]  BSTR strPassword,
  [out] BSTR *pstrPFX
);

Paramètres

[in] strPassword

Mot de passe pour le 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, effacez-le de la mémoire en appelant la fonction SecureZeroMemory . Pour plus d’informations sur la protection du mot de passe, consultez Gestion des mots de passe.

[out] pstrPFX

Pointeur vers un BSTR qui reçoit les informations de certificat au format PFX codé en base64. Lorsque vous avez terminé d’utiliser le BSTR, libérez-le en appelant la fonction SysFreeString .

Valeur retournée

C++

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.

VB

La valeur de retour est une chaîne qui contient les informations de certificat au format PFX.

Remarques

Cette méthode est désactivée lorsque le contrôle d’inscription de certificat est exécuté en tant que contrôle scripté.

Spécifications


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

Partager via