Função UnregisterPointerInputTarget (winuser.h)

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

Sintaxe

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

Parâmetros

[in] hwnd

Janela para não ser registrado como um destino de redirecionamento global em sua área de trabalho.

[in] pointerType

Tipo de entrada de ponteiro para não ser mais redirecionado 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 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 que chamou com êxito a função RegisterPointerInputTarget pode chamar essa função para cancelar o registro da janela da função de destino redirecionado global para o tipo de ponteiro especificado.

Um aplicativo que registrou a mesma janela que um destino de redirecionamento global para vários tipos de entrada de ponteiro pode chamar o UnregisterPointerInputTarget para cancelar o registro da janela para um desses tipos, deixando a janela registrada para os tipos restantes.

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 janela especificada não for o destino de redirecionamento global registrado para o tipo de entrada de ponteiro especificado em sua área de trabalho, essa função não tomará nenhuma ação e retornará êxito.

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