IContextMenu3::HandleMenuMsg2 메서드(shobjidl_core.h)

IContextMenu3 인터페이스의 클라이언트 개체가 소유자가 그린 메뉴 항목과 연결된 메시지를 처리할 수 있도록 허용합니다.

구문

HRESULT HandleMenuMsg2(
  UINT    uMsg,
  WPARAM  wParam,
  LPARAM  lParam,
  LRESULT *plResult
);

매개 변수

uMsg

형식: UINT

처리할 메시지입니다. WM_INITMENUPOPUP, WM_DRAWITEM, WM_MENUCHAR 또는 WM_MEASUREITEM 같은 일부 메시지의 경우 호출되는 클라이언트 개체는 소유자가 그린 메뉴 항목을 제공할 수 있습니다.

wParam

형식: WPARAM

추가 메시지 정보입니다. 이 매개 변수의 값은 uMsg 매개 변수의 값에 따라 달라집니다.

lParam

형식: LPARAM

추가 메시지 정보입니다. 이 매개 변수의 값은 uMsg 매개 변수의 값에 따라 달라집니다.

plResult

형식: LRESULT*

메뉴 소유자가 메시지에서 반환할 LRESULT 값의 주소입니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

IContextMenu3::HandleMenuMsg2는 일반적으로 IContextMenu2::HandleMenuMsg를 대체하며 IContextMenu3이 지원되고 지원되는 메시지 중 하나(uMsg 참조)가 수신된 경우 호출됩니다. 그러나 경우에 따라 IContextMenu2::HandleMenuMsg 가 여전히 호출됩니다. 상황에 맞는 메뉴 호스트는 또는 두 메서드를 통해 메뉴 메시지를 디스패치할 수 있습니다. 따라서 셸 확장이 IContextMenu2::HandleMenuMsg 및 IContextMenu3::HandleMenuMsg2를 모두 구현하는 경우 메뉴 메시지가 두 메서드를 통해 도착할 수 있도록 준비해야 합니다.

참고IContextMenu3 이 구현되지 않은 경우 IContextMenu2 가 해당 위치에서 호출된다는 보장은 없습니다. 경우에 따라 IContextMenu3 의 부재가 결정된 다음 프로세스가 중지됩니다.

 

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)
DLL	Shell32.dll(버전 4.71 이상)