Fungsi SfcIsKeyProtected (sfc.h)

Menentukan apakah kunci registri yang ditentukan dilindungi. Aplikasi harus menghindari mengganti kunci registri yang dilindungi.

Sintaks

BOOL SfcIsKeyProtected(
  [in]           HKEY    KeyHandle,
  [in, optional] LPCWSTR SubKeyName,
  [in]           REGSAM  KeySam
);

Parameter

[in] KeyHandle

Handel ke kunci registri akar. Ini harus menjadi handel untuk salah satu kunci yang telah ditentukan sebelumnya berikut.

HKEY_CLASSES_ROOT

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_USERS

[in, optional] SubKeyName

Nilai untai (karakter) yang dihentikan null yang berisi nama subkunjang. Kunci ini harus merupakan subkuntangan kunci yang diidentifikasi oleh parameter hKey . Untuk informasi selengkapnya tentang nama kunci, lihat Struktur Registri. Jika parameter ini NULL, fungsi hanya memeriksa apakah kunci registri akar dilindungi.

[in] KeySam

Konstanta yang menentukan tampilan registri alternatif yang harus digunakan oleh aplikasi yang berjalan pada Windows 64-bit. Bendera ini diabaikan pada platform x86. Untuk informasi selengkapnya, lihat Mengakses Tampilan Registri Alternatif.

Mengembalikan nilai

Jika kunci dilindungi, nilai yang dikembalikan adalah nilai bukan nol.

Jika kunci tidak dilindungi, nilai yang dikembalikan adalah nol.

Keterangan

Kunci dilindungi oleh WRP jika jalur ada dan dilindungi oleh WRP. Fungsi SfcIsKeyProtected menunjukkan bahwa subkunci dilindungi oleh WRP jika subkunci memiliki kunci induk yang dilindungi oleh WRP.

Misalnya, jika kunci registri berikut ada pada sistem dan dilindungi oleh WRP:

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>

Fungsi SfcIsKeyProtected mengembalikan nilai bukan nol untuk subkunci berikut. Subkuntang baru tidak perlu ada untuk fungsi untuk menentukan bahwa itu dilindungi WRP.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Classes
         Microsoft
            <WinFeature>
               <new subkey>

Persyaratan

Lihat juga

SfcIsFileProtected