允许调用方注销目标窗口,指定类型的所有指针输入都重定向到该窗口。
语法
BOOL UnregisterPointerInputTarget(
[in] HWND hwnd,
[in] POINTER_INPUT_TYPE pointerType
);
参数
[in] hwnd
要在其桌面上取消注册为全局重定向目标的窗口。
[in] pointerType
不再重定向到指定窗口的指针输入的类型。 这是 POINTER_INPUT_TYPE 枚举中任何有效且受支持的值。 请注意,泛型 PT_POINTER 类型和 PT_MOUSE 类型在此参数中无效。
返回值
如果函数成功,则返回值为非零。
如果函数失败,则返回值为零。 要获得更多的错误信息,请调用 GetLastError。
注解
成功调用 RegisterPointerInputTarget 函数的应用程序可以调用此函数,以取消注册指定指针类型的全局重定向目标角色中的窗口。
已注册与多个指针输入类型的全局重定向目标相同的窗口的应用程序可以调用 UnregisterPointerInputTarget ,以取消注册其中一种类型的窗口,同时为其余类型注册窗口。
如果调用线程没有 UI 访问权限,此函数将失败,最后一个错误设置为 ERROR_ACCESS_DENIED。
如果指定的指针输入类型无效,则此函数将失败,最后一个错误设置为 ERROR_INVALID_PARAMETER。
如果调用线程不拥有指定的窗口,则此函数将失败,最后一个错误设置为 ERROR_ACCESS_DENIED。
如果指定窗口不是其桌面上指定指针输入类型的已注册全局重定向目标,则此函数不执行任何操作并返回成功。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 8 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winuser.h (包括 Windows.h) |
| Library | User32.lib |
| DLL | User32.dll |