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

另请参阅

组策略函数

组策略概述

UnregisterGPNotification