Fungsi CertEnumSystemStore (wincrypt.h)

Artikel
03/15/2023

Fungsi CertEnumSystemStore mengambil penyimpanan sistem yang tersedia. Fungsi ini memanggil fungsi panggilan balik yang disediakan untuk setiap penyimpanan sistem yang ditemukan.

Sintaks

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

Parameter

[in] dwFlags

Menentukan lokasi penyimpanan sistem. Parameter ini bisa menjadi salah satu bendera berikut:

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 dapat digabungkan, dengan menggunakan operasi bitwise-OR, dengan salah satu bendera lokasi kata tinggi.

[in, optional] pvSystemStoreLocationPara

Jika CERT_SYSTEM_STORE_RELOCATE_FLAG diatur dalam parameter dwFlags , pvSystemStoreLocationPara menunjuk ke struktur CERT_SYSTEM_STORE_RELOCATE_PARA yang menunjukkan nama dan lokasi penyimpanan sistem. Jika tidak, pvSystemStoreLocationPara adalah penunjuk ke string Unicode yang menamai penyimpanan sistem.

Untuk CERT_SYSTEM_STORE_LOCAL_MACHINE atau CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY, pvSystemStoreLocationPara secara opsional dapat diatur ke nama komputer Unicode untuk menghitung penyimpanan komputer lokal di komputer jarak jauh, misalnya "\\computer_name" atau "computer_name". Garis miring terbelakang (\) bersifat opsional dalam computer_name.

Untuk CERT_SYSTEM_STORE_SERVICES atau CERT_SYSTEM_STORE_USERS, jika pvSystemStoreLocationPara adalah NULL, fungsi menghitung nama layanan/pengguna dan penyimpanan untuk setiap layanan/nama pengguna. Jika tidak, pvSystemStoreLocationPara adalah string Unicode yang berisi nama komputer jarak jauh dan, jika tersedia, nama layanan/pengguna, misalnya, "service_name", "\\computer_name", atau "computer_name".

Jika hanya computer_name yang ditentukan, itu harus memiliki garis miring terbelakang awal (\) atau garis miring terbelakang (\). Jika tidak, itu ditafsirkan sebagai service_name atau user_name.

[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 sistem. Fungsi panggilan balik ini menentukan konten dan format untuk presentasi informasi di setiap penyimpanan sistem. Aplikasi harus menyediakan fungsi panggilan balik CertEnumSystemStoreCallback .

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE.

Keterangan

Untuk menggunakan CertEnumSystemStore, aplikasi harus mendeklarasikan dan menentukan struktur ENUM_ARG dan fungsi panggilan balik CertEnumSystemStoreCallback .

Contoh

Untuk contoh yang menggunakan fungsi ini, 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