ChangeWindowMessageFilterEx 函数 (winuser.h)

  • 项目

修改指定窗口 (UIPI) 消息筛选器的用户界面特权隔离。

语法

BOOL ChangeWindowMessageFilterEx(
  [in]                HWND                hwnd,
  [in]                UINT                message,
  [in]                DWORD               action,
  [in, out, optional] PCHANGEFILTERSTRUCT pChangeFilterStruct
);

参数

[in] hwnd

类型：HWND

要修改其 UIPI 消息筛选器的窗口的句柄。

[in] message

类型： UINT

消息筛选器允许通过 或 阻止的消息。

[in] action

类型：DWORD

要执行的操作，可以采用以下值之一：

值 含义
MSGFLT_ALLOW
1
 允许消息通过筛选器。 这使 hWnd 能够接收消息，无论消息的来源如何，即使消息来自较低特权进程也是如此。
MSGFLT_DISALLOW
2
 阻止消息从较低特权进程传递到 hWnd ，除非使用 ChangeWindowMessageFilter 函数或全局允许该消息在进程范围内传递。
MSGFLT_RESET
0
 将 hWnd 的窗口消息筛选器重置为默认值。 允许全局或进程范围内的任何消息都将通过，但任何未包含在这两个类别中以及来自较低特权进程的消息都将被阻止。

[in, out, optional] pChangeFilterStruct

类型： PCHANGEFILTERSTRUCT

指向 CHANGEFILTERSTRUCT 结构的可选指针。

返回值

类型： BOOL

如果函数成功，则返回 TRUE;否则，它将返回 FALSE。 要获得更多的错误信息，请调用 GetLastError。

注解

UIPI 是一项安全功能，可防止从较低完整性级别的发件人接收消息。 可以使用此函数允许将特定消息传递到窗口，即使消息源自较低完整性级别的进程也是如此。 与控制进程消息筛选器的 ChangeWindowMessageFilter 函数不同， ChangeWindowMessageFilterEx 函数控制窗口消息筛选器。

应用程序可以使用 ChangeWindowMessageFilter 函数以进程范围的方式允许或阻止消息。 如果进程消息筛选器或窗口消息筛选器允许该消息，则会将其传递到窗口。

请注意，不允许 SECURITY_MANDATORY_LOW_RID 或以下的进程更改消息筛选器。 如果这些进程调用此函数，它将失败并生成扩展错误代码， ERROR_ACCESS_DENIED。

无论筛选器设置如何，值小于 WM_USER 的某些消息都需要通过筛选器传递。 尝试使用此函数允许或阻止此类消息时，将不起作用。

要求

要求 值
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll
API 集 Windows 10版本 10.0.1 (0240 中引入的 ext-ms-win-ntuser-gui-l1-3-0)

另请参阅

ChangeWindowMessageFilter

概念性

引用

Windows