BINDSPEED 枚举 (oleidl.h)

指示调用方将等待绑定到对象的大致时间。

语法

typedef enum tagBINDSPEED {
  BINDSPEED_INDEFINITE = 1,
  BINDSPEED_MODERATE = 2,
  BINDSPEED_IMMEDIATE = 3
} BINDSPEED;

常量

 
BINDSPEED_INDEFINITE
值:1
绑定操作没有时间限制。
BINDSPEED_MODERATE
值: 2
绑定操作必须在中等时间内完成。

如果指定了此标志, 则 IOleItemContainer::GetObject 的实现应返回MK_E_EXCEEEDEDDEADLINE,除非以下语气为 true:


  • 对象已处于运行状态。

  • 对象是一个伪对象, (项容器内部的对象,例如电子表格中的单元格区域或字处理器) 中的字符范围。

  • 该对象受进程内服务器 (因此在加载) 时始终处于运行状态。 在这种情况下, GetObject 应加载指定的对象,如果 OleIsRunning 函数指示对象正在运行,则返回成功。

BINDSPEED_IMMEDIATE
值: 3
调用方将只等待一小段时间。 在这种情况下,绑定操作应返回MK_E_EXCEEEDEDDEADLINE,除非对象已处于运行状态或为伪对象。

注解

系统提供的项名字对象实现是 IOleItemContainer::GetObject 的主要调用方。 它指定的 BINDSPEED 值取决于名字对象操作的调用方指定的截止时间。

截止时间存储在传递给名字对象操作的绑定上下文中BIND_OPTS结构的 dwTickCountDeadline 字段中。 此值基于 GetTickCount 函数的返回值。 如果 dwTickCountDeadline 为零(指示没有截止时间),则项名字对象实现将指定BINDSPEED_INDEFINITE。 (这是 CreateBindCtx 函数返回的绑定上下文的默认 dwTickCountDeadline 值。) 如果 dwTickCountDeadlineGetTickCount 返回的值之间的差异大于 2500,则项名字对象实现将指定BINDSPEED_MODERATE。 如果差值小于 2500,则项名字对象实现指定BINDSPEED_IMMEDIATE。

GetObject 的实现可以使用 BINDSPEED 值作为绑定截止时间的快捷方式近似值,也可以使用 IBindCtx 实例参数来确定确切的截止时间。

要求

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

另请参阅

BIND_OPTS

IBindCtx

IOleItemContainer::GetObject