Metodo Store.Load

Articolo
06/13/2023

[Il metodo Load è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Usare invece la classe X509Store nello spazio dei nomi System.Security.Cryptography.X509Certificates .

Il metodo Load importa i certificati da un file nell'archivio.

Sintassi

Store.Load( _
  ByVal FileName, _
  [ ByVal Password ], _
  [ ByVal KeyStorageFlag ] _
)

Parametri

FileName [in]

Stringa che contiene il percorso di un file con segno con estensione cer, sst, spc, p7s o pfx o qualsiasi file Authenticode firmato.

Password [in, facoltativo]

Stringa contenente la password di testo non crittografato nel file. Per la password è possibile usare fino a 32 caratteri Unicode, inclusi un carattere null terminante. Per informazioni sulla protezione della password, vedere Gestione delle password.

KeyStorageFlag [in, facoltativo]

Valore dell'enumerazione CAPICOM_KEY_STORAGE_FLAG che definisce i flag di archiviazione delle chiavi. Il valore predefinito è CAPICOM_KEY_STORAGE_DEFAULT. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
CAPICOM_KEY_STORAGE_DEFAULT	Archiviazione chiave predefinita.
CAPICOM_KEY_STORAGE_EXPORTABLE	La chiave è esportabile.
CAPICOM_KEY_STORAGE_USER_PROTECTED	La chiave è protetta dall'utente.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Se il metodo Load viene chiamato in un archivio memoria, tutti i contenitori di chiavi creati verranno eliminati quando l'archivio memoria viene eliminato. Ad esempio, se un file con estensione pfx viene caricato in un archivio memoria e successivamente aggiunto a un archivio di sistema (ad esempio l'archivio personale) dall'archivio memoria, il certificato nell'archivio personale non conterrà una chiave. In questo caso, il file pfx deve essere caricato direttamente nell'archivio personale.

Questo metodo genera CAPICOM_E_NOT_ALLOWED quando viene eseguito lo script da un'applicazione basata sul Web.

Se la password non riesce a decrittografare il file di chiave privata, il provider di servizi di crittografia predefinito deve essere sottoposto a query. Se il provider CSP predefinito è il provider di crittografia Di base Microsoft e l'operazione di decrittografia ha esito negativo, l'operazione di decrittografia deve essere riprovata con il provider di crittografia avanzata Microsoft o il provider di crittografia avanzata Microsoft, disponibile.

Se il certificato caricato nell'archivio è uguale a quello già presente, il metodo Load eliminerà il certificato esistente dall'archivio e quindi aggiungerà il nuovo certificato. Il nuovo certificato erediterà le proprietà dal certificato esistente. Il contenitore di chiavi private esistente viene sostituito dal nuovo contenitore di chiavi private.

Requisiti

Requisito	Valore
Componente ridistribuibile	CAPICOM 2.0 o versione successiva in Windows Server 2003 e Windows XP
DLL	Capicom.dll

Vedi anche

Archivio