CertEnumSystemStore-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CertEnumSystemStore-Funktion ruft die verfügbaren Systemspeicher ab. Die Funktion ruft die bereitgestellte Rückruffunktion für jeden gefundenen Systemspeicher auf.

Syntax

BOOL CertEnumSystemStore(
  [in]           DWORD                      dwFlags,
  [in, optional] void                       *pvSystemStoreLocationPara,
  [in]           void                       *pvArg,
  [in]           PFN_CERT_ENUM_SYSTEM_STORE pfnEnum
);

Parameter

[in] dwFlags

Gibt den Speicherort des Systemspeichers an. Dieser Parameter kann eines der folgenden Flags sein:

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 kann die CERT_SYSTEM_STORE_RELOCATE_FLAG mithilfe eines bitweisen OR-Vorgangs mit jedem der Flags für die Position mit hohen Wörtern kombiniert werden.

[in, optional] pvSystemStoreLocationPara

Wenn CERT_SYSTEM_STORE_RELOCATE_FLAG im dwFlags-Parameter festgelegt ist, verweist pvSystemStoreLocationPara auf eine CERT_SYSTEM_STORE_RELOCATE_PARA Struktur, die sowohl den Namen als auch den Speicherort des Systemspeichers angibt. Andernfalls ist pvSystemStoreLocationPara ein Zeiger auf eine Unicode-Zeichenfolge, die den Systemspeicher benennt.

Für CERT_SYSTEM_STORE_LOCAL_MACHINE oder CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY kann pvSystemStoreLocationPara optional auf einen Unicode-Computernamen festgelegt werden, um lokale Computerspeicher auf einem Remotecomputer aufzulisten, z. B. "\\computer_name" oder "computer_name". Die führenden umgekehrten Schrägstriche (\) sind im computer_name optional.

Wenn für CERT_SYSTEM_STORE_SERVICES oder CERT_SYSTEM_STORE_USERS pvSystemStoreLocationParaNULL ist, listet die Funktion sowohl die Dienst-/Benutzernamen als auch die Speicher für jeden Dienst-/Benutzernamen auf. Andernfalls ist pvSystemStoreLocationPara eine Unicode-Zeichenfolge, die einen Remotecomputernamen und, falls verfügbar, einen Dienst-/Benutzernamen enthält, z. B. "service_name", "\\computer_name" oder "computer_name".

Wenn nur der computer_name angegeben ist, muss er entweder die führenden umgekehrten Schrägstriche (\) oder einen nachfolgenden umgekehrten Schrägstrich (\) aufweisen. Andernfalls wird er als service_name oder user_name interpretiert.

[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, mit der die Details für jeden Systemspeicher angezeigt werden. Diese Rückruffunktion bestimmt den Inhalt und das Format für die Darstellung der Informationen in jedem Systemspeicher. Die Anwendung muss die Rückruffunktion CertEnumSystemStoreCallback bereitstellen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TRUE zurück.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben.

Hinweise

Um CertEnumSystemStore verwenden zu können, muss die Anwendung die ENUM_ARG-Struktur und die Rückruffunktion CertEnumSystemStoreCallback deklarieren und definieren.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Beispiel-C-Programm: Auflistung von System- und physischen Speicher.

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