Freigeben über


CertEnumPhysicalStore-Funktion (wincrypt.h)

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

Weitere Informationen

CERT_SYSTEM_STORE_RELOCATE_PARA

CertEnumSystemStore

CertEnumSystemStoreLocation

CertRegisterPhysicalStore

CertRegisterSystemStore

CertUnregisterPhysicalStore

CertUnregisterSystemStore

Zertifikatspeicherfunktionen