UnregisterPointerInputTarget 関数 (winuser.h)

呼び出し元が、指定した型のすべてのポインター入力がリダイレクトされるターゲット ウィンドウの登録を解除できるようにします。

構文

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

パラメーター

[in] hwnd

デスクトップ上のグローバル リダイレクト ターゲットとして登録解除されるウィンドウ。

[in] pointerType

へのポインター入力の種類は、指定されたウィンドウにリダイレクトされなくなりました。 これは、 POINTER_INPUT_TYPE 列挙体の有効でサポートされている値です。 ジェネリック PT_POINTER 型と PT_MOUSE 型は、このパラメーターでは無効であることに注意してください。

戻り値

関数が成功した場合、戻り値は 0 以外です。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

RegisterPointerInputTarget 関数を正常に呼び出したアプリケーションは、この関数を呼び出して、指定されたポインター型のグローバル リダイレクト ターゲットのロールからウィンドウの登録を解除できます。

複数のポインター入力型のグローバル リダイレクト ターゲットと同じウィンドウを登録しているアプリケーションは 、UnregisterPointerInputTarget を呼び出して、残りの型に登録されたウィンドウを残したまま、これらの型のいずれかのウィンドウの登録を解除できます。

呼び出し元のスレッドに UI アクセス特権がない場合、この関数は失敗し、最後のエラーが ERROR_ACCESS_DENIED に設定されます。

指定したポインター入力型が無効な場合、この関数は最後のエラーが ERROR_INVALID_PARAMETER に設定されて失敗します。

呼び出し元のスレッドが指定されたウィンドウを所有していない場合、この関数は最後のエラーが ERROR_ACCESS_DENIED に設定された状態で失敗します。

指定したウィンドウが、デスクトップ上の指定したポインター入力型の登録済みグローバル リダイレクト ターゲットでない場合、この関数は何も実行せず、成功を返します。

要件

要件	値
サポートされている最小のクライアント	Windows 8 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2012 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll