unregisterPointerInputTarget 函式 (winuser.h)

允許呼叫端取消註冊目標視窗，以重新導向指定型別的所有指標輸入。

語法

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

參數

[in] hwnd

要在其桌面上取消註冊為全域重新導向目標的視窗。

[in] pointerType

不再重新導向至指定視窗的指標輸入類型。 這是來自 POINTER_INPUT_TYPE 列舉的任何有效且支援的值。 請注意，泛型 PT_POINTER 型別和 PT_MOUSE 型別在此參數中無效。

傳回值

如果函式成功，則傳回值為非零。

如果此函式失敗，則傳回值為零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

成功呼叫 RegisterPointerInputTarget 函式的應用程式可以呼叫此函式，以取消註冊指定指標類型之全域重新導向目標角色的視窗。

已註冊與多個指標輸入類型的全域重新導向目標相同的視窗的應用程式，可以呼叫 UnregisterPointerInputTarget 來取消註冊這些類型之一的視窗，同時讓視窗向其餘類型註冊。

如果呼叫線程沒有UI存取許可權，此函式會失敗，並將最後一個錯誤設定為 ERROR_ACCESS_DENIED。

如果指定的指標輸入類型無效，此函式會失敗，並將最後一個錯誤設定為 ERROR_INVALID_PARAMETER。

如果呼叫線程沒有擁有指定的視窗，此函式會失敗，並將最後一個錯誤設定為 ERROR_ACCESS_DENIED。

如果指定的視窗不是其桌面上指定指標輸入類型的已註冊全域重新導向目標，則此函式不會採取任何動作並傳回成功。

規格需求