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 |