Funzione UnregisterPointerInputTarget (winuser.h)

Consente al chiamante di annullare la registrazione di una finestra di destinazione a cui viene reindirizzato tutto l'input del puntatore del tipo specificato.

Sintassi

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

Parametri

[in] hwnd

Finestra da annullare la registrazione come destinazione di reindirizzamento globale sul desktop.

[in] pointerType

Tipo di input del puntatore da non reindirizzare più alla finestra specificata. Si tratta di qualsiasi valore valido e supportato dall'enumerazione POINTER_INPUT_TYPE . Si noti che il tipo di PT_POINTER generico e il tipo di PT_MOUSE non sono validi in questo parametro.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Un'applicazione che ha chiamato correttamente la funzione RegisterPointerInputTarget può chiamare questa funzione per annullare la registrazione della finestra dal ruolo della destinazione reindirizzata globale per il tipo di puntatore specificato.

Un'applicazione che ha registrato la stessa finestra di una destinazione di reindirizzamento globale per più tipi di input del puntatore può chiamare UnregisterPointerInputTarget per annullare la registrazione della finestra per uno di questi tipi lasciando la finestra registrata per i tipi rimanenti.

Se il thread chiamante non ha il privilegio accesso all'interfaccia utente, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_ACCESS_DENIED.

Se il tipo di input del puntatore specificato non è valido, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_INVALID_PARAMETER.

Se il thread chiamante non è proprietario della finestra specificata, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_ACCESS_DENIED.

Se la finestra specificata non è la destinazione di reindirizzamento globale registrata per il tipo di input del puntatore specificato sul desktop, questa funzione non esegue alcuna azione e restituisce l'esito positivo.

Requisiti