IBindCtx：：GetObjectParam 方法 (objidl.h)

  • 项目

检索指向与绑定上下文的字符串键的指针表中的指定键关联的对象的接口指针。

语法

HRESULT GetObjectParam(
  [in]  LPOLESTR pszKey,
  [out] IUnknown **ppunk
);

参数

[in] pszKey

要搜索的 绑定上下文字符串键 。 键字符串比较区分大小写。

[out] ppunk

接收指向与 pszKey 关联的对象的接口指针的 IUnknown* 指针变量的地址。 成功后，实现会在 *ppunk 上调用 AddRef。 调用 发布由调用方负责。 如果发生错误，实现会将 *ppunk 设置为 NULL。

返回值

如果该方法成功，则返回值S_OK。 否则，它将E_FAIL。

注解

绑定上下文维护一个接口指针表，每个指针都与一个字符串键相关联。 这将启用名字对象实现与发起绑定操作的调用方之间的通信。 一方可以将接口指针存储在双方已知的字符串下，以便另一方以后可以从绑定上下文中检索它。

此方法检索的指针必须以前已使用 IBindCtx：：RegisterObjectParam 方法插入到表中。

调用方备注

当绑定操作无法获取有关所发生错误的特定信息时，使用名字对象查找其他对象的对象可以调用此方法。 根据错误，可以更正这种情况并重试绑定操作。 有关详细信息 ，请参阅 IBindCtx：：RegisterObjectParam 。

名字对象实现可以调用此方法来处理调用方启动绑定操作并请求特定信息的情况。 按照约定，实现者应使用以名字对象类 CLSID 的字符串形式开头的键名称。 (请参阅 StringFromCLSID function.)

要求

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

另请参阅

IBindCtx