Fungsi CertRegisterSystemStore (wincrypt.h)

Artikel
03/15/2023

Fungsi CertRegisterSystemStore mendaftarkan penyimpanan sistem.

Sintaks

BOOL CertRegisterSystemStore(
  [in] const void              *pvSystemStore,
  [in] DWORD                   dwFlags,
  [in] PCERT_SYSTEM_STORE_INFO pStoreInfo,
  [in] void                    *pvReserved
);

Parameter

[in] pvSystemStore

Mengidentifikasi penyimpanan sistem yang akan didaftarkan. Jika CERT_SYSTEM_STORE_RELOCATE_FLAG diatur dalam parameter dwFlags , pvSystemStore menunjuk ke struktur CERT_SYSTEM_STORE_RELOCATE_PARA . Jika tidak, ini menunjuk ke string Unicode yang dihentikan null yang menamai penyimpanan sistem.

Dengan pengaturan yang sesuai di dwFlags, penyimpanan yang diidentifikasi dapat menjadi penyimpanan sistem di komputer lokal jarak jauh. Penyimpanan pada komputer jarak jauh dapat didaftarkan dengan nama komputer sebagai awalan untuk nama penyimpanan sistem. Misalnya, penyimpanan komputer lokal jarak jauh dapat didaftarkan dengan pvSystemStore yang menunjuk ke string "\ComputerName\Trust" atau "ComputerName\Trust".

Garis miring terdepan "\" bersifat opsional sebelum ComputerName.

[in] dwFlags

Kata tinggi dari parameter dwFlags digunakan untuk menentukan lokasi penyimpanan sistem.

Nilai kata tinggi berikut didefinisikan.

Nilai	Makna
CERT_SYSTEM_STORE_CURRENT_SERVICE	pvSystemStore dapat menjadi nama penyimpanan sistem yang diawali dengan ServiceName.
CERT_SYSTEM_STORE_CURRENT_USER	pvSystemStore dapat menjadi nama penyimpanan sistem yang diawali dengan UserName.
CERT_SYSTEM_STORE_LOCAL_MACHINE	pvSystemStore dapat menjadi penyimpanan sistem yang ada di komputer jarak jauh.
CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY	pvSystemStore adalah penyimpanan kebijakan grup dan dapat berada di komputer jarak jauh.
CERT_SYSTEM_STORE_SERVICES	pvSystemStore harus berupa nama penyimpanan sistem yang diawali dengan ServiceName.
CERT_SYSTEM_STORE_USERS	pvSystemStore harus merupakan nama penyimpanan sistem yang diawali dengan UserName.

Toko pada komputer jarak jauh dapat didaftarkan untuk CERT_SYSTEM_STORE_LOCAL_MACHINE, CERT_SYSTEM_STORE_SERVICES, CERT_SYSTEM_STORE_USERS, atau CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY.

Nilai kata rendah berikut juga ditentukan dan dapat digabungkan menggunakan operasi bitwise-OR dengan nilai kata tinggi.

Nilai	Makna
CERT_SYSTEM_STORE_RELOCATE_FLAG	Penyimpanan sistem tidak berada di lokasi register default dan pvSystemStore harus menjadi penunjuk ke struktur CERT_SYSTEM_STORE_RELOCATE_PARA .
CERT_STORE_CREATE_NEW_FLAG	Fungsi gagal jika penyimpanan sistem sudah ada di lokasi penyimpanan.

[in] pStoreInfo

Dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

[in] pvReserved

Dicadangkan untuk digunakan di masa mendatang dan harus diatur ke NULL.

Mengembalikan nilai

Jika fungsi berhasil, fungsi mengembalikan bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol.

Keterangan

Untuk membatalkan pendaftaran penyimpanan sistem yang telah didaftarkan oleh fungsi ini, panggil CertUnregisterSystemStore.

Contoh

Contoh berikut menunjukkan penambahan penyimpanan sistem ke koleksi penyimpanan sistem registri. Untuk contoh yang menyertakan konteks lengkap untuk contoh ini, lihat Contoh Program C: Mencantumkan Sistem dan Penyimpanan Fisik.

//--------------------------------------------------------------------
// Declare and initialize variables.

LPCWSTR pvSystemName= L"NEWSTORE";  // For this setting of 
                                    // dwFlags, the store name may 
                                    // be prefixed with a user name.
DWORD dwFlags= CERT_SYSTEM_STORE_CURRENT_USER;

if(CertRegisterSystemStore(
    pvSystemName,
    dwFlags,
    NULL,
    NULL))
{
  printf("System store %S is registered. \n",pvSystemName);
}
else
{
  printf("The system store did not register. \n");
  exit(1);
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	wincrypt.h
Pustaka	Crypt32.lib
DLL	Crypt32.dll