IBindCtx 接口 (objidl.h)
提供对绑定上下文的访问,绑定上下文是一个对象,用于存储有关特定名字对象绑定操作的信息。
继承
IBindCtx 接口继承自 IUnknown 接口。 IBindCtx 还具有以下类型的成员:
方法
IBindCtx 接口具有这些方法。
IBindCtx::EnumObjectParam 检索指向接口的指针,该接口可用于枚举绑定上下文的字符串键型指针表的键。 |
IBindCtx::GetBindOptions 检索存储在此绑定上下文中的绑定选项。 |
IBindCtx::GetObjectParam 检索指向与绑定上下文的字符串键型指针表中的指定键关联的对象的接口指针。 |
IBindCtx::GetRunningObjectTable 检索指向运行此绑定上下文的计算机 (ROT) 正在运行的对象表的接口指针。 |
IBindCtx::RegisterObjectBound 向绑定上下文注册对象,以确保该对象在释放绑定上下文之前保持活动状态。 |
IBindCtx::RegisterObjectParam 将 对象与绑定上下文的字符串键型指针表中的字符串键相关联。 |
IBindCtx::ReleaseBoundObjects 释放指向以前通过调用 RegisterObjectBound 注册的所有对象的指针。 |
IBindCtx::RevokeObjectBound 从绑定上下文中删除 对象,撤消对 RegisterObjectBound 的先前调用。 |
IBindCtx::RevokeObjectParam 从绑定上下文的字符串键对象表中删除指定的键及其关联的指针。 之前必须通过调用 RegisterObjectParam 将键插入表中。 |
IBindCtx::SetBindOptions 为绑定上下文中存储的绑定参数设置新值。 |
注解
绑定上下文包括以下信息:
- 一个BIND_OPTS结构,包含一组在绑定操作期间不会更改的参数。 绑定复合名字对象时,每个组件使用相同的绑定上下文,因此它充当一种机制,用于将相同的参数传递给复合名字对象的每个组件。
- 指向绑定操作已激活的对象的一组指针。 绑定上下文保存指向这些绑定对象的指针,使其保持加载状态,从而在后续绑定操作期间再次需要这些对象时消除冗余激活。
- 指向正在运行的对象表的指针 (ROT) 与启动绑定操作的进程位于同一台计算机上。 需要访问 ROT 的 Moniker 实现应使用 IBindCtx::GetRunningObjectTable 方法,而不是使用 GetRunningObjectTable 函数。 这允许将来对系统的 IBindCtx 实现进行增强以修改绑定行为。
- 接口指针的表,每个指针都与一个字符串键相关联。 此功能使名字对象实现能够将接口指针存储在已知字符串下,以便以后可以从绑定上下文中检索它们。 例如,OLE 定义了多个字符串键 (“ExceededDeadline”、“ConnectManually”等) ,这些键可用于存储指向在绑定操作期间导致错误的对象的指针。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 专业版 [桌面应用 |UWP 应用] |
最低受支持的服务器 | Windows 2000 Server [桌面应用 |UWP 应用] |
目标平台 | Windows |
标头 | objidl.h |