Metodo ICertificate2::Save

[CAPICOM è un componente solo a 32 bit disponibile per l'uso nei sistemi operativi seguenti: Windows Server 2008, Windows Vista e Windows XP. Usare invece la classe X509Certificate2 nello spazio dei nomi System.Security.Cryptography.X509Certificates .

Il metodo Save salva il certificato in un file. Questo metodo è stato introdotto in CAPICOM 2.0.

Sintassi

Certificate.Save( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal SaveAs ], _
  [ ByVal IncludeOption ] _
)

Parametri

FileName [in]

Stringa contenente il nome del file di output in cui verrà salvato il certificato.

Password [in, facoltativo]

Stringa contenente la password di testo non crittografato per un file di chiave privata . La password può contenere fino a 32 caratteri Unicode, incluso un carattere Null di terminazione. Per informazioni sulla protezione della password, vedere Gestione delle password.

SalvaAs [in, facoltativo]

Valore dell'enumerazione CAPICOM_CERTIFICATE_SAVE_AS_TYPE che specifica il formato del file di output. Il valore predefinito è CAPICOM_CERTIFICATE_SAVE_AS_CER. Nella tabella seguente sono illustrati i possibili valori.

Valore	Significato
CAPICOM_CERTIFICATE_SAVE_AS_CER	Il file di output verrà formattato come file con estensione cer senza chiavi private salvate.
CAPICOM_CERTIFICATE_SAVE_AS_PFX	Il file di output verrà formattato come file PFX (PKCS #12) e verranno salvate anche tutte le chiavi private associate esportabili.

 

IncludeOption [in, facoltativo]

Valore dell'enumerazione CAPICOM_CERTIFICATE_INCLUDE_OPTION che specifica il numero di certificati nella catena salvati nel file di output. Il valore predefinito è CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY. Nella tabella seguente sono illustrati i possibili valori.

Valore	Significato
CAPICOM_CERTIFICATE_INCLUDE_CHAIN_EXCEPT_ROOT	Salva tutti i certificati nella catena ad eccezione dell'entità radice
CAPICOM_CERTIFICATE_INCLUDE_WHOLE_CHAIN	Salva la catena di certificati completa
CAPICOM_CERTIFICATE_INCLUDE_END_ENTITY_ONLY	Salva solo il certificato dell'entità finale

 

Valore restituito

Questo metodo non restituisce valori.

Commenti

Questo metodo genera CAPICOM_E_NOT_ALLOWED quando viene creato uno script da un'applicazione basata sul Web.

Requisiti