Funzione RegisterPointerInputTarget (winuser.h)

Consente al chiamante di registrare una finestra di destinazione in cui viene reindirizzato tutto l'input del puntatore del tipo specificato.

Sintassi

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

Parametri

[in] hwnd

Finestra da registrare come destinazione di reindirizzamento globale.

Il reindirizzamento può causare la perdita dell'attivazione (stato attivo) della finestra in primo piano. Per evitare questo problema, assicurarsi che la finestra sia una finestra di solo messaggio o che abbia il set di stili WS_EX_NOACTIVATE .

[in] pointerType

Tipo di input del puntatore da reindirizzare 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 con privilegi di accesso all'interfaccia utente può usare questa funzione per registrare la propria finestra per ricevere tutto l'input del tipo di input del puntatore specificato. Ogni desktop consente una sola finestra di destinazione di reindirizzamento globale per ogni tipo di input del puntatore in qualsiasi momento. La prima finestra da registrare rimane attiva fino a quando la finestra non viene annullata o eliminata definitivamente, a quel punto il ruolo è disponibile per il chiamante qualificato successivo.

Mentre la registrazione è attiva, tutto l'input del tipo di puntatore specificato, indipendentemente dal fatto che si tratti di un dispositivo di input o inserito da un'applicazione, viene reindirizzato alla finestra registrata. Tuttavia, quando il processo proprietario della finestra registrata inserisce l'input del tipo di puntatore specificato, tale inserimento non viene reindirizzato ma viene invece elaborato normalmente.

Un'applicazione che desidera registrare la stessa finestra di una destinazione di reindirizzamento globale per più tipi di input del puntatore deve chiamare più volte la funzione RegisterPointerInputTarget , una volta per ogni tipo di input del puntatore di interesse.

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 il desktop della finestra specificata dispone già di una destinazione di reindirizzamento globale registrata per il tipo di input del puntatore specificato, questa funzione ha esito negativo con l'ultimo errore impostato su ERROR_ACCESS_DENIED.

Requisiti