CryptCATAdminAcquireContext-Funktion (mscat.h)

  • Artikel

[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

Weitere Informationen

CryptCATAdminAddCatalog

CryptCATAdminReleaseContext

CryptCATAdminRemoveCatalog