Funzione CryptCATPersistStore (mscat.h)

  • Articolo

[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
ERROR_INVALID_PARAMETER
 Uno o più parametri non sono validi.
ERROR_NOT_SUPPORTED
 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