CertEnumPhysicalStore-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CertEnumPhysicalStore-Funktion ruft die physischen Speicher auf einem Computer ab. Die Funktion ruft die bereitgestellte Rückruffunktion für jeden gefundenen physischen Speicher auf.

Syntax

BOOL CertEnumPhysicalStore(
  [in] const void                   *pvSystemStore,
  [in] DWORD                        dwFlags,
  [in] void                         *pvArg,
  [in] PFN_CERT_ENUM_PHYSICAL_STORE pfnEnum
);

Parameter

[in] pvSystemStore

Wenn CERT_SYSTEM_STORE_RELOCATE_FLAG in dwFlags festgelegt ist, verweist pvSystemStore auf eine CERT_SYSTEM_STORE_RELOCATE_PARA Struktur, die sowohl den Namen als auch den Speicherort des aufzuzählnden Systemspeichers angibt. Andernfalls ist pvSystemStore ein Zeiger auf eine Unicode-Zeichenfolge, die den Systemspeicher benennt, dessen physische Speicher aufgezählt werden sollen. Informationen zum Voranstellen von ServiceName oder ComputerName zum Systemspeichernamen finden Sie unter CertRegisterSystemStore.

[in] dwFlags

Gibt den Speicherort des Systemspeichers an. Die folgenden Flagwerte werden definiert:

CERT_SYSTEM_STORE_CURRENT_USER
CERT_SYSTEM_STORE_CURRENT_SERVICE
CERT_SYSTEM_STORE_LOCAL_MACHINE
CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY
CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY
CERT_SYSTEM_STORE_SERVICES
CERT_SYSTEM_STORE_USERS
CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE

Darüber hinaus können CERT_SYSTEM_STORE_RELOCATE_FLAG oder CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG mithilfe eines bitweisen OR-Vorgangs mit einem der Ortungsflags mit hohen Wörtern kombiniert werden.

[in] pvArg

Ein Zeiger auf eine void , mit dem die Anwendung eine Struktur deklarieren, definieren und initialisieren kann, um alle Informationen zu enthalten, die an die Rückrufaufzählungsfunktion übergeben werden sollen.

[in] pfnEnum

Ein Zeiger auf die Rückruffunktion, die verwendet wird, um die Details für jeden physischen Speicher anzuzeigen. Diese Rückruffunktion bestimmt den Inhalt und das Format für die Darstellung der Informationen in jedem physischen Speicher. Die Anwendung muss die Rückruffunktion CertEnumPhysicalStoreCallback bereitstellen.

Rückgabewert

Wenn die Funktion erfolgreich ist und ein anderer physischer Speicher gefunden wurde, ist der Rückgabewert TRUE.

Wenn der Systemspeicherort nur Systemspeicher und keine physischen Speicher unterstützt, gibt die Funktion FALSE zurück, und GetLastError gibt den ERROR_NOT_SUPPORTED Code zurück.

Wenn die Funktion fehlschlägt und kein anderer physischer Speicher gefunden wurde, lautet der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Hinweise

Um CertEnumPhysicalStore zu verwenden, muss eine Anwendung die ENUM_ARG-Struktur und eine Enumerationsrückruffunktion deklarieren und definieren.

Beispiele

Weitere Informationen finden Sie unter Beispiel-C-Programm: Auflisten von System- und physischen Filialen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h
Bibliothek	Crypt32.lib
DLL	Crypt32.dll