Fungsi CertEnumPhysicalStore (wincrypt.h)

Artikel
03/15/2023

Fungsi CertEnumPhysicalStore mengambil penyimpanan fisik di komputer. Fungsi ini memanggil fungsi panggilan balik yang disediakan untuk setiap penyimpanan fisik yang ditemukan.

Sintaks

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

Parameter

[in] pvSystemStore

Jika CERT_SYSTEM_STORE_RELOCATE_FLAG diatur dalam dwFlags, pvSystemStore menunjuk ke struktur CERT_SYSTEM_STORE_RELOCATE_PARA yang menunjukkan nama dan lokasi penyimpanan sistem yang akan dijumlahkan. Jika tidak, pvSystemStore adalah penunjuk ke string Unicode yang menamai penyimpanan sistem yang penyimpanan fisiknya akan dijumlahkan. Untuk informasi tentang awalan ServiceName atau ComputerName ke nama penyimpanan sistem, lihat CertRegisterSystemStore.

[in] dwFlags

Menentukan lokasi penyimpanan sistem. Nilai bendera berikut ditentukan:

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

Selain itu, CERT_SYSTEM_STORE_RELOCATE_FLAG atau CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG dapat digabungkan menggunakan operasi bitwise-OR dengan salah satu bendera lokasi kata tinggi.

[in] pvArg

Penunjuk ke kekosongan yang memungkinkan aplikasi untuk mendeklarasikan, menentukan, dan menginisialisasi struktur untuk menyimpan informasi apa pun yang akan diteruskan ke fungsi enumerasi panggilan balik.

[in] pfnEnum

Penunjuk ke fungsi panggilan balik yang digunakan untuk menampilkan detail untuk setiap penyimpanan fisik. Fungsi panggilan balik ini menentukan konten dan format untuk presentasi informasi di setiap penyimpanan fisik. Aplikasi harus menyediakan fungsi panggilan balik CertEnumPhysicalStoreCallback .

Mengembalikan nilai

Jika fungsi berhasil dan penyimpanan fisik lain ditemukan, nilai yang dikembalikan adalah TRUE.

Jika lokasi penyimpanan sistem hanya mendukung penyimpanan sistem dan tidak mendukung penyimpanan fisik, fungsi mengembalikan FALSE dan GetLastError mengembalikan kode ERROR_NOT_SUPPORTED.

Jika fungsi gagal dan penyimpanan fisik lain tidak ditemukan, nilai yang dikembalikan adalah FALSE. Untuk informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Untuk menggunakan CertEnumPhysicalStore, aplikasi harus mendeklarasikan dan menentukan struktur ENUM_ARG dan fungsi panggilan balik enumerasi.

Contoh

Lihat Contoh Program C: Mencantumkan Sistem dan Penyimpanan Fisik.

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll