Metodo ICertSrvSetup::CAImportPFX (casetup.h)

Articolo
02/26/2024

Il metodo CAImportPFX importa un certificato dell'autorità di certificazione (CA) e la chiave privata associata nell'archivio computer locale. Questo metodo non modifica lo stato dell'oggetto CCertSrvSetup .

Sintassi

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

Parametri

[in] bstrFileName

Stringa contenente il nome di un file PFX utilizzato per importare una chiave privata.

[in] bstrPasswd

Stringa contenente una password per il file PFX.

[in] bOverwriteExistingKey

Valore che indica se sovrascrivere una chiave esistente con lo stesso nome.

[out] ppVal

Indirizzo di un puntatore a un'interfaccia ICertSrvSetupKeyInformation che può essere usata per impostare le proprietà della chiave privata importata.

Valore restituito

nessuno

Osservazioni

Il metodo CAImportPFX usa i parametri di input per decrittografare e decodificare un file PFX e quindi installare la chiave e il certificato nell'archivio computer locale. Se il certificato soddisfa i criteri seguenti e dopo l'installazione della chiave, il metodo restituisce un oggetto ICertSrvSetupKeyInformation al chiamante.

Contiene una chiave AT_SIGNATURE che corrisponde alla chiave nel contenitore di chiavi private.
È autofirmato o ha vincoli di base per una CA.
Supera la convalida della catena, ma potrebbe verificarsi un errore di revoca offline.

Se il file PFX contiene più certificati e chiavi, CAImportPFX installa tutti i certificati e le chiavi; Tuttavia, l'oggetto ICertSrvSetupKeyInformation restituito contiene solo le proprietà dell'ultimo certificato CA nel file. Al termine dell'utilizzo dell'oggetto ICertSrvSetupKeyInformation , il chiamante deve rilasciarlo usando il metodo Release .

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	casetup.h
DLL	Certocm.dll

Vedi anche

ICertSrvSetup

Condividi tramite