Funzione CryptCATOpen (mscat.h)

Articolo
08/24/2023

[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

Condividi tramite