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에 도입됨) |