Condividi tramite


Funzione CryptCATAdminAcquireContext (mscat.h)

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

La funzione CryptCATAdminAcquireContext acquisisce un handle in un contesto di amministratore del catalogo. Questo handle può essere usato dalle chiamate successive alle funzioni CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash e CryptCATAdminRemoveCatalog . Questa funzione non ha alcuna libreria di importazione associata. È necessario usare le funzioni LoadLibrary e GetProcAddress per collegare dinamicamente a Wintrust.dll.

Sintassi

BOOL CryptCATAdminAcquireContext(
  [out] HCATADMIN  *phCatAdmin,
  [in]  const GUID *pgSubsystem,
  [in]  DWORD      dwFlags
);

Parametri

[out] phCatAdmin

Puntatore all'handle di contesto dell'amministratore del catalogo assegnato da questa funzione. Al termine dell'uso dell'handle, chiuderlo chiamando la funzione CryptCATAdminReleaseContext .

[in] pgSubsystem

Puntatore al GUID che identifica il sottosistema. DRIVER_ACTION_VERIFY rappresenta il sottosistema per i componenti del sistema operativo e i driver di terze parti. Si tratta del sottosistema usato dalla maggior parte delle implementazioni.

[in] dwFlags

Non usato; impostato su zero.

Valore restituito

Il valore restituito è TRUE se la funzione ha esito positivo; FALSE se la funzione ha esito negativo.

Per informazioni sull'errore estese, chiamare la funzione GetLastError . Per un elenco completo dei codici di errore forniti dal sistema operativo, vedere Codici di errore di 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

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog