CryptCATAdminRemoveCatalog-Funktion (mscat.h)
[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 |