Bagikan melalui

Fungsi PowerSettingAccessCheckEx (powrprof.h)

  • Artikel

Kueri untuk penimpaan kebijakan grup untuk pengaturan daya tertentu dan menentukan akses yang diminta untuk pengaturan tersebut.

Sintaks

DWORD PowerSettingAccessCheckEx(
  [in]           POWER_DATA_ACCESSOR AccessFlags,
  [in, optional] const GUID          *PowerGuid,
  [in]           REGSAM              AccessType
);

Parameter

[in] AccessFlags

Jenis akses untuk memeriksa penimpaan kebijakan grup.

Nilai Makna
ACCESS_AC_POWER_SETTING_INDEX
0 (0x0)
 Periksa penggantian pada pengaturan daya AC.
ACCESS_DC_POWER_SETTING_INDEX
1 (0x1)
 Periksa penimpaan pada pengaturan daya DC.
ACCESS_SCHEME
16 (0x10)
 Periksa pembatasan pada skema daya tertentu.
ACCESS_ACTIVE_SCHEME
19 (0x13)
 Periksa pembatasan pada skema daya aktif.
ACCESS_CREATE_SCHEME
20 (0x14)
 Periksa batasan pembuatan atau pemulihan skema daya.

[in, optional] PowerGuid

Pengidentifikasi pengaturan daya.

[in] AccessType

Jenis akses keamanan untuk pengaturan. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Parameter ini bisa menjadi salah satu nilai berikut.

Nilai Makna
KEY_READ
 Menggabungkan nilai STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, dan KEY_NOTIFY.
KEY_WRITE
 Menggabungkan hak akses STANDARD_RIGHTS_WRITE, KEY_SET_VALUE, dan KEY_CREATE_SUB_KEY.

Mengembalikan nilai

Mengembalikan ERROR_SUCCESS (nol) jika panggilan berhasil, dan nilai bukan nol jika panggilan gagal.

Mengembalikan kode/nilai Deskripsi
ERROR_SUCCESS
0 (0x0)
 Pengaturan daya yang ditentukan saat ini tidak ditimpa oleh kebijakan grup.
ERROR_ACCESS_DISABLED_BY_POLICY
1260 (0x4EC)
 Program ini diblokir oleh kebijakan grup. Hubungi administrator sistem Anda untuk mengetahui informasi selengkapnya.
ERROR_INSTALL_REMOTE_DISALLOWED
1640 (0x668)
 Hanya Administrator yang dapat mengakses pengaturan daya dari jarak jauh.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform Windows
Header powrprof.h
Pustaka Powrprof.lib
DLL Powrprof.dll