Funzione CryptCATOpen (mscat.h)

  • Articolo

[La funzione CryptCATOpen è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

La funzione CryptCATOpen apre un catalogo e restituisce un handle di contesto al catalogo aperto.

Nota Alcune versioni precedenti di Wintrust.lib non contengono le informazioni di esportazione per questa funzione. In questo caso, è necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Wintrust.dll.
 

Sintassi

HANDLE CryptCATOpen(
  [in] LPWSTR     pwszFileName,
  [in] DWORD      fdwOpenFlags,
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwPublicVersion,
  [in] DWORD      dwEncodingType
);

Parametri

[in] pwszFileName

Puntatore a una stringa con terminazione Null per il nome del file di catalogo.

[in] fdwOpenFlags

Zero, per aprire un file di catalogo esistente o una combinazione bit per bit di uno o più dei valori seguenti.

Valore Significato
CRYPTCAT_OPEN_ALWAYS
 Apre il file, se esistente o crea un nuovo file, se necessario.
CRYPTCAT_OPEN_CREATENEW
 Viene creato un nuovo file di catalogo. Se esiste un file creato in precedenza, viene sovrascritto.
CRYPTCAT_OPEN_EXISTING
 Viene aperto un file di catalogo esistente.
CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES
 Viene aperto un file di catalogo esistente. Escludere gli hash di pagina in SPC_INDIRECT_DATA.
CRYPTCAT_OPEN_INCLUDE_PAGE_HASHES
 Viene aperto un file di catalogo esistente. Includi hash di pagina in SPC_INDIRECT_DATA. La CRYPTCAT_OPEN_EXCLUDE_PAGE_HASHES precedente ha la precedenza se impostata.
CRYPTCAT_OPEN_VERIFYSIGHASH
 Viene aperto un file di catalogo esistente. Verifica la firma, non i certificati.
CRYPTCAT_OPEN_NO_CONTENT_HCRYPTMSG
 Viene aperto un file di catalogo esistente. Esegue CryptMsgDecode senza contenuto.
CRYPTCAT_OPEN_SORTED
 Viene aperto un file di catalogo esistente. Esegue CertCreateContext(CERT_CREATE_CONTEXT_SORTED_FLAG).

[in] hProv

Handle per un provider di servizi di crittografia (CSP).

[in] dwPublicVersion

Versione del file Può trattarsi di uno dei valori seguenti.

Valore Significato
CRYPTCAT_VERSION_1
0x100
 Formato di file versione 1.
CRYPTCAT_VERSION_2
0x200
 Formato di file versione 2.

Windows 8 e Windows Server 2012: Inizia il supporto per questo valore.

[in] dwEncodingType

Tipo di codifica usato per il file. Se questo valore è 0, il tipo di codifica viene impostato su PKCS_7_ASN_ENCODING | X509_ASN_ENCODING.

Valore restituito

Al termine dell'operazione, questa funzione restituisce un handle al catalogo aperto. Al termine dell'uso dell'handle, chiuderlo chiamando la funzione CryptCATClose . La funzione CryptCATOpen restituisce INVALID_HANDLE_VALUE se ha esito negativo.

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

Vedi anche

CryptCATClose