Función RegisterPointerInputTarget (winuser.h)

Permite al autor de la llamada registrar una ventana de destino a la que se redirige toda la entrada de puntero del tipo especificado.

Sintaxis

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

Parámetros

[in] hwnd

Ventana que se va a registrar como destino de redireccionamiento global.

El redireccionamiento puede hacer que la ventana de primer plano pierda la activación (foco). Para evitarlo, asegúrese de que la ventana sea una ventana de solo mensaje o que tenga el estilo WS_EX_NOACTIVATE establecido.

[in] pointerType

Tipo de entrada de puntero que se redirigirá a la ventana especificada. Se trata de cualquier valor válido y admitido de la enumeración POINTER_INPUT_TYPE . Tenga en cuenta que el tipo de PT_POINTER genérico y el tipo de PT_MOUSE no son válidos en este parámetro.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Una aplicación con el privilegio de acceso a la interfaz de usuario puede usar esta función para registrar su propia ventana para recibir toda la entrada del tipo de entrada de puntero especificado. Cada escritorio solo permite una ventana de destino de redirección global para cada tipo de entrada de puntero en un momento dado. La primera ventana que se va a registrar correctamente permanece en vigor hasta que la ventana no se registra o se destruye, momento en el que el rol está disponible para el siguiente llamador calificado.

Mientras el registro está en vigor, toda la entrada del tipo de puntero especificado, ya sea desde un dispositivo de entrada o insertado por una aplicación, se redirige a la ventana registrada. Sin embargo, cuando el proceso que posee la ventana registrada inserta la entrada del tipo de puntero especificado, dicho tipo insertado no se redirige, sino que se procesa normalmente.

Una aplicación que desee registrar la misma ventana que un destino de redireccionamiento global para varios tipos de entrada de puntero debe llamar a la función RegisterPointerInputTarget varias veces, una vez para cada tipo de entrada de puntero de interés.

Si el subproceso que realiza la llamada no tiene el privilegio de acceso a la interfaz de usuario, esta función produce el último error establecido en ERROR_ACCESS_DENIED.

Si el tipo de entrada de puntero especificado no es válido, esta función produce el último error establecido en ERROR_INVALID_PARAMETER.

Si el subproceso que realiza la llamada no posee la ventana especificada, esta función produce el último error establecido en ERROR_ACCESS_DENIED.

Si el escritorio de la ventana especificada ya tiene un destino de redirección global registrado para el tipo de entrada de puntero especificado, esta función produce el último error establecido en ERROR_ACCESS_DENIED.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	winuser.h (incluir Windows.h)
Library	User32.lib
Archivo DLL	User32.dll