CryptCATAdminAcquireContext-Funktion (mscat.h)
[Die CryptCATAdminAcquireContext-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Die CryptCATAdminAcquireContext-Funktion ruft ein Handle für einen Katalogadministratorkontext ab. Dieses Handle kann durch nachfolgende Aufrufe der Funktionen CryptCATAdminAddCatalog, CryptCATAdminEnumCatalogFromHash und CryptCATAdminRemoveCatalog verwendet werden. Diese Funktion verfügt über keine zugeordnete Importbibliothek. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Wintrust.dll.
Syntax
BOOL CryptCATAdminAcquireContext(
[out] HCATADMIN *phCatAdmin,
[in] const GUID *pgSubsystem,
[in] DWORD dwFlags
);
Parameter
[out] phCatAdmin
Ein Zeiger auf das Kontexthandle des Katalogadministrators, das von dieser Funktion zugewiesen wird. Wenn Sie die Verwendung des Handles abgeschlossen haben, schließen Sie es, indem Sie die Funktion CryptCATAdminReleaseContext aufrufen.
[in] pgSubsystem
Ein Zeiger auf die GUID, die das Subsystem identifiziert. DRIVER_ACTION_VERIFY stellt das Subsystem für Betriebssystemkomponenten und Treiber von Drittanbietern dar. Dies ist das Subsystem, das von den meisten Implementierungen verwendet wird.
[in] dwFlags
Nicht verwendet; auf 0 festgelegt.
Rückgabewert
Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist. FALSE , wenn die Funktion fehlschlägt.
Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten. Eine vollständige Liste der vom Betriebssystem bereitgestellten Fehlercodes finden Sie unter Systemfehlercodes.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | mscat.h |
| Bibliothek | Wintrust.lib |
| DLL | Wintrust.dll |