ICertSrvSetup ::CAImportPFX, méthode (casetup.h)

Article
02/23/2024

La méthode CAImportPFX importe un certificat d’autorité de certification et sa clé privée associée dans le magasin d’ordinateurs local. Cette méthode ne modifie pas l’état de l’objet CCertSrvSetup .

Syntaxe

HRESULT CAImportPFX(
  [in]  const BSTR                  bstrFileName,
  [in]  const BSTR                  bstrPasswd,
  [in]  VARIANT_BOOL                bOverwriteExistingKey,
  [out] ICertSrvSetupKeyInformation **ppVal
);

Paramètres

[in] bstrFileName

Chaîne qui contient le nom d’un fichier PFX utilisé pour importer une clé privée.

[in] bstrPasswd

Chaîne qui contient un mot de passe pour le fichier PFX.

[in] bOverwriteExistingKey

Valeur qui indique s’il faut remplacer une clé existante du même nom.

[out] ppVal

Adresse d’un pointeur vers une interface ICertSrvSetupKeyInformation qui peut être utilisée pour définir les propriétés de la clé privée importée.

Valeur de retour

None

Remarques

La méthode CAImportPFX utilise les paramètres d’entrée pour déchiffrer et décoder un fichier PFX, puis installe la clé et le certificat dans le magasin d’ordinateurs local. Si le certificat répond aux critères suivants et après l’installation de la clé, la méthode retourne un objet ICertSrvSetupKeyInformation à l’appelant.

Contient une clé AT_SIGNATURE qui correspond à la clé dans le conteneur de clé privée.
Est auto-signé ou a des contraintes de base pour une autorité de certification.
Réussit la validation de chaîne, mais peut avoir une erreur de révocation hors connexion.

Si le fichier PFX contient plusieurs certificats et clés, CAImportPFX installe tous les certificats et clés ; toutefois, l’objet ICertSrvSetupKeyInformation retourné contient uniquement les propriétés du dernier certificat d’autorité de certification dans le fichier. Lorsque l’appelant a terminé d’utiliser l’objet ICertSrvSetupKeyInformation , l’appelant doit le libérer à l’aide de la méthode Release .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	casetup.h
DLL	Certocm.dll

Voir aussi

ICertSrvSetup

Partager via