RegisterGPNotification 函数 (userenv.h)
RegisterGPNotification 函数使应用程序能够在策略发生更改时接收通知。 发生策略更改时,指定的事件对象将设置为信号状态。
语法
USERENVAPI BOOL RegisterGPNotification(
[in] HANDLE hEvent,
[in] BOOL bMachine
);
参数
[in] hEvent
事件对象的句柄。 使用 CreateEvent 函数创建事件对象。
[in] bMachine
指定策略更改类型。 如果 为 TRUE,则报告计算机策略更改。 如果 为 FALSE,则报告用户策略更改。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
调用 UnregisterGPNotification 函数以取消注册从接收策略更改通知的句柄。 调用 CloseHandle 函数以在不再需要句柄时将其关闭。
当广播 WM_SETTINGCHANGE 消息时,应用程序还可以接收有关策略更改的通知。 在此实例中,如果应用了计算机策略, 则 wParam 参数值为 1;如果应用了用户策略,则为零。 lParam 参数指向字符串“Policy”。
要求
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | userenv.h |
Library | Userenv.lib |
DLL | Userenv.dll |