Поделиться через

Функция UnregisterPointerInputTarget (winuser.h)

  • Статья

Позволяет вызывающей объекту отменить регистрацию целевого окна, в которое перенаправляются все входные данные указателя указанного типа.

Синтаксис

BOOL UnregisterPointerInputTarget(
  [in] HWND               hwnd,
  [in] POINTER_INPUT_TYPE pointerType
);

Параметры

[in] hwnd

Окно для отмены регистрации в качестве глобального целевого объекта перенаправления на рабочем столе.

[in] pointerType

Тип входных данных указателя, которые больше не будут перенаправляться в указанное окно. Это любое допустимое и поддерживаемое значение из перечисления POINTER_INPUT_TYPE . Обратите внимание, что универсальный тип PT_POINTER и тип PT_MOUSE недопустимы в этом параметре.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение не равно нулю.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Приложение, которое успешно вызвало функцию RegisterPointerInputTarget , может вызвать эту функцию, чтобы отменить регистрацию окна из роли глобального перенаправленного целевого объекта для указанного типа указателя.

Приложение, которое зарегистрировало то же окно, что и глобальный целевой объект перенаправления для нескольких типов входных данных указателя, может вызвать UnregisterPointerInputTarget , чтобы отменить регистрацию окна для одного из этих типов, оставив окно зарегистрированным для остальных типов.

Если вызывающий поток не имеет прав доступа к пользовательскому интерфейсу, эта функция завершается сбоем с последней ошибкой ERROR_ACCESS_DENIED.

Если указанный тип входных данных указателя недопустим, эта функция завершается ошибкой с последней ошибкой ERROR_INVALID_PARAMETER.

Если вызывающему потоку не принадлежит указанное окно, эта функция завершается сбоем с последней ошибкой ERROR_ACCESS_DENIED.

Если указанное окно не является зарегистрированным глобальным целевым объектом перенаправления для указанного типа входных данных указателя на рабочем столе, эта функция не выполняет никаких действий и возвращает успешное выполнение.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll