CryptCATAdminAddCatalog-Funktion (mscat.h)

  • Artikel

[Die Funktion CryptCATAdminAddCatalog ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die Funktion CryptCATAdminAddCatalog fügt der Katalogdatenbank einen Katalog hinzu. Die Katalogdatenbank ist ein Index, der dateihashes den Katalogen zuordnet, die sie enthalten. Sie wird verwendet, um die Identifizierung der Kataloge beim Überprüfen der Dateisignatur zu beschleunigen. Diese Funktion ist die einzige unterstützte Möglichkeit zum programmgesteuerten Hinzufügen von Katalogen zur Windows-Katalogdatenbank. Der Funktion ist keine Importbibliothek zugeordnet. Sie müssen die Funktionen LoadLibrary und GetProcAddress verwenden, um dynamisch mit Wintrust.dll zu verknüpfen.

Syntax

HCATINFO CryptCATAdminAddCatalog(
  [in] HCATADMIN hCatAdmin,
  [in] PWSTR     pwszCatalogFile,
  [in] PWSTR     pwszSelectBaseName,
  [in] DWORD     dwFlags
);

Parameter

[in] hCatAdmin

Handle, das zuvor von der Funktion CryptCATAdminAcquireContext zugewiesen wurde.

[in] pwszCatalogFile

Ein Zeiger auf eine NULL-endende Zeichenfolge für den vollqualifizierten Pfad des hinzuzufügenden Katalogs.

[in] pwszSelectBaseName

Ein Zeiger auf eine NULL-endende Zeichenfolge für den Namen des Katalogs, wenn er gespeichert wird. Wenn der Parameter NULL ist, wird ein eindeutiger Name für den Katalog generiert.

[in] dwFlags

Wenn das flag CRYPTCAT_ADDCATALOG_HARDLINK (0x00000001) angegeben wird, wird der im Aufruf angegebene Katalog nicht kopiert, sondern mit hart verknüpft. Das Feste Verknüpfen eines Katalogs anstelle des Kopierens eines Katalogs reduziert den von Windows benötigten Speicherplatz.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Kataloginformationskontext. Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Nachdem Sie das zurückgegebene Handle verwendet haben, geben Sie es frei, indem Sie die Funktion CryptCATAdminReleaseCatalogContext aufrufen.

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

CryptCATAdminAcquireContext

CryptCATAdminReleaseCatalogContext