Fungsi RegisterGPNotification (userenv.h)
Fungsi RegisterGPNotification memungkinkan aplikasi menerima pemberitahuan ketika ada perubahan kebijakan. Ketika perubahan kebijakan terjadi, objek peristiwa yang ditentukan diatur ke status yang disinyalkan.
Sintaks
USERENVAPI BOOL RegisterGPNotification(
[in] HANDLE hEvent,
[in] BOOL bMachine
);
Parameter
[in] hEvent
Menangani ke objek peristiwa. Gunakan fungsi CreateEvent untuk membuat objek peristiwa.
[in] bMachine
Menentukan jenis perubahan kebijakan. Jika TRUE, perubahan kebijakan komputer akan dilaporkan. Jika FALSE, perubahan kebijakan pengguna akan dilaporkan.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Panggil fungsi UnregisterGPNotification untuk membatalkan pendaftaran handel dari menerima pemberitahuan perubahan kebijakan. Panggil fungsi CloseHandle untuk menutup handel saat tidak lagi diperlukan.
Aplikasi juga dapat menerima pemberitahuan tentang perubahan kebijakan saat pesan WM_SETTINGCHANGE disiarkan. Dalam hal ini, nilai parameter wParam adalah 1 jika kebijakan komputer diterapkan; nol jika kebijakan pengguna diterapkan. Parameter lParam menunjuk ke string "Policy".
Persyaratan
| Klien minimum yang didukung | Windows Vista |
| Server minimum yang didukung | Windows Server 2008 |
| Target Platform | Windows |
| Header | userenv.h |
| Pustaka | Userenv.lib |
| DLL | Userenv.dll |