OleSetMenuDescriptor 함수(ole2.h)

컨테이너의 프레임 창에서 OLE 디스패치 코드를 설치하거나 제거합니다.

구문

HRESULT OleSetMenuDescriptor(
  [in] HOLEMENU                 holemenu,
  [in] HWND                     hwndFrame,
  [in] HWND                     hwndActiveObject,
  [in] LPOLEINPLACEFRAME        lpFrame,
  [in] LPOLEINPLACEACTIVEOBJECT lpActiveObj
);

매개 변수

[in] holemenu

OleCreateMenuDescriptor 함수에서 반환된 복합 메뉴 설명자에 대한 핸들입니다. NULL이면 디스패치 코드가 해제됩니다.

[in] hwndFrame

현재 위치 복합 메뉴를 설치할 컨테이너의 프레임 창에 대한 핸들입니다.

[in] hwndActiveObject

개체의 현재 위치 활성화 창에 대한 핸들입니다. OLE는 메뉴 메시지와 명령을 이 창으로 디스패치합니다.

[in] lpFrame

컨테이너의 프레임 창에 있는 IOleInPlaceFrame 인터페이스에 대한 포인터입니다.

[in] lpActiveObj

현재 위치 개체의 IOleInPlaceActiveObject 인터페이스에 대한 포인터입니다.

반환 값

이 함수는 성공에 대한 S_OK 반환합니다.

설명

컨테이너는 OleSetMenuDescriptor를 호출하여 개체가 IOleInPlaceFrame::SetMenu 메서드를 호출할 때 hwndFrame에 디스패치 코드를 설치하거나 NULL을 OleSetMenuDescriptor에 대한 값으로 전달하여 디스패치 코드를 제거해야 합니다.

lpFrame 및 lpActiveObj 매개 변수가 모두 NULL이 아닌 경우 OLE는 애플리케이션에 대한 상황에 맞는 도움말 F1 메시지 필터를 설치합니다. 그렇지 않으면 애플리케이션에서 자체 메시지 필터를 제공해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ole2.h
라이브러리	Ole32.lib
DLL	Ole32.dll
API 세트	ext-ms-win-com-ole32-l1-1-5(Windows 10 버전 10.0.15063에 도입됨)

추가 정보

IOleInPlaceActiveObject

IOleInPlaceFrame::SetMenu

OleCreateMenuDescriptor