IOleInPlaceSiteWindowless::OnDefWindowMessage 메서드(ocidl.h)

아티클
08/25/2023

개체에 전달된 모든 메시지에 대한 기본 처리를 호출합니다.

구문

HRESULT OnDefWindowMessage(
  [in]  UINT    msg,
  [in]  WPARAM  wParam,
  [in]  LPARAM  lParam,
  [out] LRESULT *plResult
);

매개 변수

[in] msg

Windows에서 컨테이너에 제공한 창 메시지의 식별자입니다.

[in] wParam

Windows에서 컨테이너에 제공한 창 메시지에 대한 매개 변수입니다.

[in] lParam

Windows에서 컨테이너에 제공한 창 메시지에 대한 매개 변수입니다.

[out] plResult

창 메시지의 결과 코드에 대한 포인터입니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 다른 가능한 반환 값은 다음과 같습니다.

반환 코드	설명
S_FALSE	창 메시지에 대한 컨테이너의 기본 처리가 호출되지 않았습니다. 아래의 구현자에 대한 참고를 참조하세요.

설명

창 없는 개체는 이 메서드를 호출하여 창 메시지에 대한 기본 처리를 명시적으로 호출할 수 있습니다. 컨테이너는 IOleInPlaceObjectWindowless::OnWindowMessage를 호출하여 창 없는 개체에 창 메시지를 디스패치합니다. 개체는 일반적으로 메시지를 처리하지 않았음을 나타내기 위해 S_FALSE 반환합니다. 그런 다음, 컨테이너는 DefWindowProc 함수를 호출하여 메시지에 대한 기본 동작을 수행할 수 있습니다.

대신 개체는 컨테이너의 사이트 개체에서 이 메서드를 호출하여 기본 처리를 명시적으로 호출할 수 있습니다. 그런 다음 컨테이너가 메시지를 처리하지 않는 경우 개체가 자체적으로 작업을 수행할 수 있습니다.

구현자에 대한 참고 사항

컨테이너는 다음 창 메시지를 기본 창 프로시저( DefWindowProc 함수)에 전달하고 S_OK 반환해야 합니다. *plResult 에는 DefWindowProc에서 반환된 값이 포함되어야 합니다.

WM_CHAR
WM_DEADCHAR
WM_IMExxx
WM_KEYDOWN
WM_KEYUP
WM_MOUSEMOVE
WM_SYSCHAR
WM_SYSDEADCHAR
WM_SYSKEYUP
WM_XBUTTONDOWN
WM_XBUTTONUP
WM_XBUTTONDBLCLK

컨테이너는 창 메시지를 자체적으로 처리하고 S_OK 반환하거나 아무 작업도 수행하지 않고 S_FALSE 반환할 수 있습니다.

WM_CONTEXTMENU
WM_HELP
WM_SETCURSOR

컨테이너가 S_FALSE 반환하는 경우 개체는 창 메시지를 자체적으로 처리하는 작업을 수행할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ocidl.h

추가 정보

IOleInPlaceObjectWindowless::OnWindowMessage

IOleInPlaceSiteWindowless

다음을 통해 공유