Funzione CryptCATAdminAddCatalog (mscat.h)

  • Articolo

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

La funzione CryptCATAdminAddCatalog aggiunge un catalogo al database del catalogo. Il database di catalogo è un indice che associa gli hash dei file ai cataloghi che li contengono. Viene usato per velocizzare l'identificazione dei cataloghi quando si verifica la firma del file. Questa funzione è l'unico modo supportato per aggiungere cataloghi a livello di codice al database del catalogo di Windows. La funzione non ha una libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Wintrust.dll.

Sintassi

HCATINFO CryptCATAdminAddCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] PWSTR     pwszCatalogFile,
  [in] PWSTR     pwszSelectBaseName,
  [in] DWORD     dwFlags
);

Parametri

[in] hCatAdmin

Gestire in precedenza assegnato dalla funzione CryptCATAdminAcquireContext .

[in] pwszCatalogFile

Puntatore a una stringa con terminazione Null per il percorso completo del catalogo da aggiungere.

[in] pwszSelectBaseName

Puntatore a una stringa con terminazione Null per il nome del catalogo quando viene archiviato. Se il parametro è NULL, verrà generato un nome univoco per il catalogo.

[in] dwFlags

Se viene specificato il flag CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001), il catalogo specificato nella chiamata verrà collegato a livello rigido anziché copiato. Il collegamento rigido anziché la copia di un catalogo riduce la quantità di spazio su disco richiesta da Windows.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il contesto delle informazioni del catalogo. Se la funzione ha esito negativo, il valore restituito è NULL. Al termine dell'uso dell'handle restituito, liberarlo chiamando la funzione CryptCATAdminReleaseCatalogContext .

Per informazioni sugli errori estesi, chiamare la funzione GetLastError . Per un elenco completo dei codici di errore forniti dal sistema operativo, vedere Codici di errore del sistema.

Requisiti

Requisito Valore
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

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext