Поделиться через

Перечисление 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, если не задано следующее:


  • Объект уже находится в состоянии выполнения.

  • Объект является псевдо-объектом (внутренним объектом контейнера элементов, например диапазоном ячеек в электронной таблице или символьным диапазоном в текстовом обработчике).

  • Объект поддерживается внутрипроцессным сервером (поэтому он всегда находится в состоянии выполнения при загрузке). В этом случае GetObject должен загрузить указанный объект и, если функция OleIsRunning указывает, что объект запущен, возвращается успешно.

BINDSPEED_IMMEDIATE
Значение: 3
Вызывающий объект ожидает только короткий промежуток времени. В этом случае операция привязки должна возвращать MK_E_EXCEEEDEDDEADLINE, если только объект не находится в состоянии выполнения или не является псевдо-объектом.

Комментарии

Предоставленная системой реализация моникера элемента является основным вызывающим объектом IOleItemContainer::GetObject. Указываемое значение BINDSPEED зависит от крайнего срока, заданного вызывающим объектом операции моникера.

Крайний срок хранится в поле dwTickCountDeadline структуры BIND_OPTS в контексте привязки, переданном в операцию моникера. Это значение основано на возвращаемом значении функции GetTickCount . Если параметр dwTickCountDeadline равен нулю, что указывает на отсутствие крайнего срока, реализация моникера элемента задает BINDSPEED_INDEFINITE. (Это значение dwTickCountDeadline по умолчанию для контекста привязки, возвращаемого функцией CreateBindCtx .) Если разница между dwTickCountDeadline и значением, возвращаемым Методом GetTickCount , больше 2500, реализация моникера элемента задает BINDSPEED_MODERATE. Если разница меньше 2500, реализация моникера элемента задает BINDSPEED_IMMEDIATE.

Реализации GetObject могут использовать значение BINDSPEED в качестве приближения к крайнему сроку привязки или использовать параметр экземпляра IBindCtx для определения точного крайнего срока.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть oleidl.h

См. также раздел

BIND_OPTS

IBindCtx

IOleItemContainer::GetObject