Funzione CertSaveStore (wincrypt.h)
La funzione CertSaveStore salva l'archivio certificati in un file o in un BLOB di memoria.
Sintassi
BOOL CertSaveStore(
[in] HCERTSTORE hCertStore,
[in] DWORD dwEncodingType,
[in] DWORD dwSaveAs,
[in] DWORD dwSaveTo,
[in, out] void *pvSaveToPara,
[in] DWORD dwFlags
);
Parametri
[in] hCertStore
Handle dell'archivio certificati da salvare.
[in] dwEncodingType
Specifica il tipo di codifica del certificato e il tipo di codifica dei messaggi. La codifica viene usata solo quando dwSaveAs contiene CERT_STORE_SAVE_AS_PKCS7. In caso contrario, il parametro dwMsgAndCertEncodingType non viene usato.
Questo parametro può essere una combinazione di uno o più dei valori seguenti.
| Valore | Significato |
|---|---|
|
Specifica la codifica dei messaggi PKCS 7. |
|
Specifica la codifica del certificato X.509. |
[in] dwSaveAs
Specifica come salvare l'archivio certificati.
Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
L'archivio certificati può essere salvato come messaggio firmato PKCS #7 che non include proprietà aggiuntive. Il parametro dwEncodingType specifica il tipo di codifica del messaggio. |
|
L'archivio certificati può essere salvato come archivio serializzato contenente proprietà oltre ai certificati codificati, agli elenchi di revoche di certificati (CRL) e agli elenchi di certificati attendibili (CRL). Il parametro dwEncodingType viene ignorato.
Nota La proprietà CERT_KEY_CONTEXT_PROP_ID e i valori CERT_KEY_PROV_HANDLE_PROP_ID e CERT_KEY_SPEC_PROP_ID correlati non vengono salvati in un archivio serializzato.
|
[in] dwSaveTo
Specifica dove e come salvare l'archivio certificati. Il contenuto di questo parametro determina il formato del parametro pvSaveToPara .
Questo parametro può avere uno dei valori seguenti.
| Valore | Significato |
|---|---|
|
La funzione salva l'archivio certificati in un file. Il parametro pvSaveToPara contiene un handle per un file ottenuto in precedenza usando la funzione CreateFile . Il file deve essere aperto con l'autorizzazione di scrittura. Dopo un'operazione di salvataggio completata, il puntatore al file viene posizionato dopo l'ultima operazione di scrittura. |
|
La funzione salva l'archivio certificati in un file. Il parametro pvSaveToPara contiene un puntatore a una stringa Unicode con terminazione Null contenente il percorso e il nome file del file in cui salvare. La funzione apre il file, lo salva e lo chiude. |
|
La funzione salva l'archivio certificati in un file. Il parametro pvSaveToPara contiene un puntatore a una stringa ANSI con terminazione Null che contiene il percorso e il nome file del file in cui salvare. La funzione apre il file, lo salva e lo chiude. |
|
La funzione salva l'archivio certificati in un file. Il parametro pvSaveToPara contiene un puntatore a una stringa Unicode con terminazione Null contenente il percorso e il nome file del file in cui salvare. La funzione apre il file, lo salva e lo chiude. |
|
La funzione salva l'archivio certificati in un BLOB di memoria. Il parametro pvSaveToPara contiene un puntatore a una struttura CERT_BLOB . Prima di usare, è necessario inizializzare i membri pbData e cbData del CERT_BLOB. Al termine della restituzione, cbData viene aggiornato con la lunghezza effettiva. Per un calcolo di sola lunghezza, pbData deve essere impostato su NULL. Se pbData non è NULL e cbData non è sufficientemente grande, la funzione restituisce zero con un ultimo codice di errore di ERROR_MORE_DATA. |
[in, out] pvSaveToPara
Puntatore che rappresenta la posizione in cui salvare l'archivio. Il contenuto di questo parametro dipende dal valore del parametro dwSaveTo .
[in] dwFlags
Questo parametro è riservato per uso futuro e deve essere impostato su zero.
Valore restituito
Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.
Se la funzione ha esito negativo, restituisce zero. Per informazioni sugli errori estesi, chiamare GetLastError.
Si noti che gli errori CreateFile o WriteFile possono essere propagati a questa funzione. Un possibile codice di errore è CRYPT_E_FILE_ERROR che indica che si è verificato un errore durante la scrittura nel file.
Requisiti
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | wincrypt.h |
| Libreria | Crypt32.lib |
| DLL | Crypt32.dll |