Compartir a través de

Función UnregisterPointerInputTarget (winuser.h)

  • Artículo

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

Sintaxis

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

Parámetros

[in] hwnd

Ventana que se va a anular la registro como destino de redireccionamiento global en su escritorio.

[in] pointerType

Tipo de entrada de puntero para que ya no se redirija a la ventana especificada. Este es 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 que ha llamado correctamente a la función RegisterPointerInputTarget puede llamar a esta función para anular el registro de la ventana desde el rol de destino redirigido global para el tipo de puntero especificado.

Una aplicación que ha registrado la misma ventana que un destino de redirección global para varios tipos de entrada de puntero puede llamar a UnregisterPointerInputTarget para anular el registro de la ventana para uno de esos tipos mientras deja la ventana registrada para los tipos restantes.

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 un error con 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 la ventana especificada no es el destino de redirección global registrado para el tipo de entrada de puntero especificado en su escritorio, esta función no realiza ninguna acción y devuelve correctamente.

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 (incluya Windows.h)
Library User32.lib
Archivo DLL User32.dll