Funzione CryptCATPersistStore (mscat.h)
[La funzione CryptCATPersistStore è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]
La funzione CryptCATPersistStore salva le informazioni nell'archivio catalogo specificato in un file di catalogo non firmato.
Sintassi
BOOL CryptCATPersistStore(
[in] HANDLE hCatalog
);
Parametri
[in] hCatalog
Handle per il catalogo ottenuto dalla funzione CryptCATHandleFromStore o CryptCATOpen . A partire da Windows 8 è necessario usare solo CryptCATOpen per recuperare un handle.
Valore restituito
Il valore restituito è TRUE se la funzione ha esito positivo; in caso contrario, FALSE.
Se questa funzione restituisce FALSE, è possibile ottenere informazioni aggiuntive sull'errore chiamando la funzione GetLastError . GetLastError restituirà il codice di errore seguente.
Codice restituito | Descrizione |
---|---|
|
Uno o più parametri non sono validi. |
|
A partire da Windows 8 e Windows Server 2012, è necessario recuperare un handle chiamando la funzione CryptCATOpen con il parametro dwPublicVersion impostato su 0x100 o 0x200. Per altre informazioni, vedere la sezione Osservazioni. |
Commenti
La struttura CRYPTCATSTORE deve essere inizializzata prima di chiamare CryptCATPersistStore.
A partire da Windows 8 e Windows Server 2012, le modifiche seguenti si applicano a questa funzione:
- Se CryptCATOpen è stato chiamato con un parametro dwPublicVersion di 0x200, il catalogo viene scritto usando il formato v2.
- Se CryptCATOpen è stato chiamato con un parametro dwPublicVersion di 0x100, il catalogo viene scritto usando il formato v1.
- Se CryptCATOpen è stato chiamato con un parametro dwPublicVersion diverso da 0x200 o 0x100, la funzione CryptCATPersistStore restituisce FALSE e il codice di errore è impostato su ERROR_NOT_SUPPORTED.
Requisiti
Client minimo supportato | Windows XP [solo app desktop] |
Server minimo supportato | Windows Server 2003 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | mscat.h |
Libreria | Wintrust.lib |
DLL | Wintrust.dll |