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