通过

CoGetObject 函数 (objbase.h)

  • 项目

将显示名称转换为标识名为 的对象的名称对象，然后绑定到由名字对象标识的对象。

语法

HRESULT CoGetObject(
  [in]           LPCWSTR   pszName,
  [in, optional] BIND_OPTS *pBindOptions,
  [in]           REFIID    riid,
  [out]          void      **ppv
);

参数

[in] pszName

要创建的对象的显示名称。

[in, optional] pBindOptions

用于创建用于创建实际对象的名字对象的绑定选项。 有关详细信息，请参阅 BIND_OPTS。 此参数可以为 NULL。

[in] riid

对在要创建的对象上实现的接口的标识符的引用。

[out] ppv

指向所创建对象上的 riid 指定的接口的指针的地址。

返回值

此函数可以返回标准返回值E_FAIL、E_OUTOFMEMORY和E_UNEXPECTED，以及以下值。

返回代码 说明
S_OK
 已成功创建对象。
MK_E_SYNTAX
 pszName 参数不是格式正确的显示名称。
MK_E_NOOBJECT
 找不到此名字对象标识的对象，或此名字对象所属的复合名字对象所标识的某个对象。
MK_E_EXCEEDEDDEADLINE
 无法在 pBindOptions 中传递的 BIND_OPTS 结构指定的时间限制内完成绑定操作。
MK_E_CONNECTMANUALLY
 绑定操作需要最终用户的帮助。 返回此值的最常见原因是需要密码或需要装载软盘。
MK_E_INTERMEDIATEINTERFACENOTSUPPORTED
 找到了中间对象，但它不支持完成绑定操作所需的接口。 例如，如果项名字对象容器不支持 IOleItemContainer 接口，则返回此值。

注解

CoGetObject 封装对 COM 库函数 CreateBindCtx、 MkParseDisplayName 和 IMoniker：：BindToObject 的调用。

要求

要求 值
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 objbase.h
Library Ole32.lib
DLL Ole32.dll

另请参阅

BIND_OPTS