Função RegisterPointerInputTarget (winuser.h)

Permite que o chamador registre uma janela de destino para a qual toda a entrada de ponteiro do tipo especificado é redirecionada.

Sintaxe

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

Parâmetros

[in] hwnd

A janela a ser registrada como um destino de redirecionamento global.

O redirecionamento pode fazer com que a janela em primeiro plano perca a ativação (foco). Para evitar isso, verifique se a janela é somente uma mensagem ou se tem o estilo WS_EX_NOACTIVATE definido.

[in] pointerType

Tipo de entrada de ponteiro a ser redirecionada para a janela especificada. Esse é qualquer valor válido e com suporte da enumeração POINTER_INPUT_TYPE . Observe que o tipo de PT_POINTER genérico e o tipo de PT_MOUSE não são válidos nesse parâmetro.

Retornar valor

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Um aplicativo com o privilégio de Acesso à Interface do Usuário pode usar essa função para registrar sua própria janela para receber toda a entrada do tipo de entrada de ponteiro especificado. Cada área de trabalho permite apenas uma janela de destino de redirecionamento global para cada tipo de entrada de ponteiro a qualquer momento. A primeira janela a ser registrada com êxito permanece em vigor até que a janela não seja registrada ou destruída, momento em que a função está disponível para o próximo chamador qualificado.

Enquanto o registro estiver em vigor, toda a entrada do tipo de ponteiro especificado, seja de um dispositivo de entrada ou injetado por um aplicativo, será redirecionada para a janela registrada. No entanto, quando o processo que possui a janela registrada injeta a entrada do tipo de ponteiro especificado, esse tipo injetado não é redirecionado, mas é processado normalmente.

Um aplicativo que deseja registrar a mesma janela que um destino de redirecionamento global para vários tipos de entrada de ponteiro deve chamar a função RegisterPointerInputTarget várias vezes, uma vez para cada tipo de entrada de ponteiro de interesse.

Se o thread de chamada não tiver o privilégio de acesso à interface do usuário, essa função falhará com o último erro definido como ERROR_ACCESS_DENIED.

Se o tipo de entrada de ponteiro especificado não for válido, essa função falhará com o último erro definido como ERROR_INVALID_PARAMETER.

Se o thread de chamada não possuir a janela especificada, essa função falhará com o último erro definido como ERROR_ACCESS_DENIED.

Se a área de trabalho da janela especificada já tiver um destino de redirecionamento global registrado para o tipo de entrada de ponteiro especificado, essa função falhará com o último erro definido como ERROR_ACCESS_DENIED.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winuser.h (inclua Windows.h)
Biblioteca	User32.lib
DLL	User32.dll