IOleWindow::GetWindow 方法 (oleidl.h)

检索参与就地激活的窗口之一的句柄, (框架、文档、父窗口或就地对象窗口) 。

语法

HRESULT GetWindow(
  [out] HWND *phwnd
);

parameters

[out] phwnd

指向接收窗口句柄的变量的指针。

返回值

此方法在成功时返回S_OK。 其他可能的返回值包括以下内容。

返回代码 说明
E_FAIL
对象是无窗口的。
E_INVALIDARG
指定的 fEnterMode 值无效。
E_OUTOFMEMORY
可用于此操作的内存不足。
E_UNEXPECTED
发生意外错误。

注解

五种类型的窗口构成窗口层次结构。 当对象就地处于活动状态时,它有权访问其中部分或全部窗口。

窗口 说明
Frame 容器应用程序的main菜单所在的最外面的main窗口。
文档 向用户显示包含嵌入对象的复合文档的窗口。
窗格 包含对象视图的文档窗口的子窗口。 仅适用于具有拆分窗格窗口的应用程序。
Parent 包含该对象的视图的容器窗口。 对象应用程序将其窗口安装为此窗口的子窗口。
就地 包含活动就地对象的窗口。 对象应用程序创建此窗口并将其安装为其阴影窗口的子窗口,该窗口是容器父窗口的子窗口。
 

每种类型的窗口在就地激活体系结构中都有不同的角色。 但是,不需要对每种类型使用单独的物理窗口。 许多容器应用程序对其框架、文档、窗格和父窗口使用相同的窗口。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 oleidl.h

请参阅

IOleWindow