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。

備註

當物件呼叫 IOleInPlaceFrame：：SetMenu 方法時，容器應該呼叫 OleSetMenuDescriptor，以在 hwndFrame 上安裝分派程式代碼，或將 NULL 當做 OleSetMenuDescriptor 的值傳遞至 OleSetMenuDescriptor 來移除分派程序代碼。

如果 lpFrame 和 lpActiveObj 參數都是非 NULL，OLE 會安裝應用程式的上下文相關說明 F1 訊息篩選。 否則，應用程式必須提供自己的訊息篩選。

規格需求

另請參閱

IOleInPlaceActiveObject

IOleInPlaceFrame：：SetMenu

OleCreateMenuDescriptor