CryptCATAdminRemoveCatalog-Funktion (mscat.h)

  • Artikel

[Die CryptCATAdminRemoveCatalog-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 Funktion CryptCATAdminRemoveCatalog löscht eine Katalogdatei und entfernt den Eintrag dieses Katalogs aus der Windows-Katalogdatenbank. Diese Funktion ist die einzige unterstützte Möglichkeit, Kataloge aus der Datenbank zu entfernen und gleichzeitig die Integrität der Datenbank sicherzustellen. Die 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 CryptCATAdminRemoveCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] LPCWSTR   pwszCatalogFile,
  [in] DWORD     dwFlags
);

Parameter

[in] hCatAdmin

Handle, der zuvor von der Funktion CryptCATAdminAcquireContext zugewiesen wurde.

[in] pwszCatalogFile

Ein Zeiger auf eine null-beendete Zeichenfolge für den Namen des zu entfernenden Katalogs. Diese Zeichenfolge darf nur den Namen ohne Pfadinformationen enthalten.

[in] dwFlags

Dieser Parameter ist für die zukünftige Verwendung reserviert und muss auf null festgelegt werden.

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