IOleObject::SetHostNames 方法 (oleidl.h)

提供对象及其容器应用程序的名称以及嵌入它的复合文档。

语法

HRESULT SetHostNames(
  [in] LPCOLESTR szContainerApp,
  [in] LPCOLESTR szContainerObj
);

参数

[in] szContainerApp

一个指针,指向运行该对象的容器应用程序的名称。

[in] szContainerObj

一个指针,指向包含该对象的复合文档的名称。 如果不希望显示复合文档的名称,可以将此参数设置为 NULL

返回值

此方法在成功时返回S_OK。

注解

调用方备注

仅为嵌入对象调用 IOleObject::SetHostNames ,因为对于链接对象,链接源提供其自己的单独编辑窗口和标题栏信息。

实施者说明

对象的 IOleObject::SetHostNames 应用应包括对其用户界面的任何修改可能适合对象的嵌入状态。 此类修改通常包括添加和删除菜单命令以及更改编辑窗口标题栏中显示的文本。

SDI 容器应用程序或具有最大化子窗口的 MDI 应用程序中嵌入对象的完整窗口标题应如下所示:

<object application name> - <object short type> in <container document>

否则,标题应为:

<object application name> - <container document>

“对象短类型”是指对象名称足够短的一种形式,可以完全显示在列表框中。 由于这些标识字符串不作为对象的持久状态的一部分存储,因此每次加载或运行对象时都必须调用 IOleObject::SetHostNames

要求

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

另请参阅

IOleObject

IOleObject::GetUserType