CryptCATAdminEnumCatalogFromHash-Funktion (mscat.h)

[Die Funktion CryptCATAdminEnumCatalogFromHash steht für die Verwendung in den Betriebssystemen zur Verfügung, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Die CryptCATAdminEnumCatalogFromHash-Funktion listet die Kataloge auf, die einen angegebenen Hash enthalten. Der Hash wird in der Regel von der Funktion CryptCATAdminCalcHashFromFileHandle zurückgegeben. Rufen Sie nach dem letzten Aufruf dieser Funktion CryptCATAdminReleaseCatalogContext auf, um den zugewiesenen Arbeitsspeicher freizugeben.

Syntax

HCATINFO CryptCATAdminEnumCatalogFromHash(
  [in] HCATADMIN hCatAdmin,
  [in] BYTE      *pbHash,
  [in] DWORD     cbHash,
  [in] DWORD     dwFlags,
  [in] HCATINFO  *phPrevCatInfo
);

Parameter

[in] hCatAdmin

Ein Handle für einen Katalogadministratorkontext, der zuvor von der Funktion CryptCATAdminAcquireContext zugewiesen wurde.

[in] pbHash

Ein Zeiger auf den Puffer, der den Durch Aufrufen von CryptCATAdminCalcHashFromFileHandle abgerufenen Hash enthält.

[in] cbHash

Anzahl der Bytes im Puffer, die für pbHash zugewiesen sind.

[in] dwFlags

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

[in] phPrevCatInfo

Ein Zeiger auf das Handle auf den vorherigen Katalogkontext oder NULL. Um den ersten Katalog abzurufen, der den Hash enthält, oder um eine Enumeration aller Kataloge zu starten, übergeben Sie NULL für diesen Parameter. Um die Enumeration fortzusetzen, übergeben Sie den Rückgabewert des vorherigen Aufrufs, bis keine weiteren Kataloge gefunden werden.

Rückgabewert

Der Rückgabewert ist ein Handle für den Katalogkontext oder NULL , wenn keine katalogen mehr aufzuzählen sind.

Hinweis: Der Typ HCATINFO ist einfach eine Typedef für HANDLE, wodurch es einfach ist, HCATINFO versehentlich im falschen Kontext zu verwenden. Insbesondere ist dies nicht mit einem handle identisch, der von CryptCATOpen zurückgegeben wird, auch wenn der Compiler Sie nicht daran hindert, HCATINFO in einer Funktion zu verwenden, die ein Kataloghandle erwartet. Um ein Kataloghandle aus dieser Funktion abzurufen, rufen Sie zuerst CryptCATCatalogInfoFromContext auf, um den Dateinamen des Katalogs abzurufen, und rufen Sie dann CryptCATOpen mit diesem Dateinamen auf.

Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten. Eine vollständige Liste der vom Betriebssystem bereitgestellten Fehlercodes finden Sie unter Systemfehlercodes.

Hinweis: Die Funktion gibt einen Wert vom Typ HCATINFO zurück, aber dies ist einfach eine Typdefinition für HANDLE. Aus diesem Grund ist es einfach, HCATINFO versehentlich zu verwenden, wenn eine Funktion aufgerufen wird, die eine andere Art von HANDLE erwartet. Insbesondere ist dies nicht dasselbe wie ein handle , der von CryptCATOpen zurückgegeben wird, auch wenn der Compiler Sie nicht daran hindert, HCATINFO in einer Funktion zu verwenden, die ein Kataloghandle erwartet.

Um ein Kataloghandle aus dieser Funktion abzurufen, rufen Sie zuerst CryptCATCatalogInfoFromContext auf, um den Dateinamen des Katalogs abzurufen, und rufen Sie dann CryptCATOpen mit diesem Dateinamen auf, um den Katalog zu öffnen.

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