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 설정되어 이 함수가 실패합니다.

지정된 창이 바탕 화면에서 지정된 포인터 입력 형식에 대해 등록된 전역 리디렉션 대상이 아닌 경우 이 함수는 아무 작업도 수행하지 않고 성공을 반환합니다.