PFN_CERT_ENUM_PHYSICAL_STORE Rückruffunktion (wincrypt.h)

Artikel
08/27/2023

Die Rückruffunktion CertEnumPhysicalStoreCallback formatiert und zeigt Informationen zu jedem physischen Speicher an, der durch einen Aufruf von CertEnumPhysicalStore gefunden wurde.

Syntax

PFN_CERT_ENUM_PHYSICAL_STORE PfnCertEnumPhysicalStore;

BOOL PfnCertEnumPhysicalStore(
  [in] const void *pvSystemStore,
  [in] DWORD dwFlags,
  [in] LPCWSTR pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void *pvReserved,
  [in] void *pvArg
)
{...}

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 des Namens eines Diensts oder Computers 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. Die CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG Konstante wird festgelegt, wenn der physische Speicher vordefiniert und nicht registriert ist.

[in] pwszStoreName

Name des physischen Speichers.

[in] pStoreInfo

Ein Zeiger auf eine CERT_PHYSICAL_STORE_INFO-Struktur , die Informationen zum Speicher enthält.

[in] pvReserved

Für die zukünftige Verwendung reserviert.

[in] pvArg

Ein Zeiger auf Informationen, die an die Rückruffunktion im pvArg übergeben werden, der an CertEnumPhysicalStore übergeben wird.

Rückgabewert

Gibt TRUE zurück, wenn die Funktion erfolgreich ist, FALSE , wenn sie fehlschlägt.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincrypt.h