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


Метод IRunnableObject::IsRunning (objidl.h)

Определяет, находится ли объект в состоянии выполнения в данный момент.

Синтаксис

BOOL IsRunning();

Возвращаемое значение

Если объект находится в состоянии выполнения, возвращается значение TRUE. В противном случае — FALSE.

Комментарии

Контейнерное приложение может вызвать IRunnableObject::IsRunning , если ему нужно узнать, доступен ли сервер немедленно. Например, реализация контейнера метода IOleItemContainer::GetObject возвращает ошибку, если сервер не запущен и параметр bindspeed указывает BINDSPEED_IMMEDIATE.

Обработчик объектов может вызывать IRunnableObject::IsRunning , если он хочет избежать конфликтов с работающим сервером или если на работающем сервере может быть больше актуальных сведений. Например, реализация обработчиком IOleObject::GetExtent делегируется серверу объектов, если он запущен, так как сведения о сервере могут быть более актуальными, чем в кэше обработчика.

OleIsRunning — это вспомогающая функция, которая удобно переупаковывает функциональные возможности, предоставляемые IRunnableObject::IsRunning. С выпуском OLE 2.01 реализация OleIsRunning была изменена таким образом, что она вызывает QueryInterface, запрашивает IRunnableObject, а затем вызывает IRunnableObject::IsRunning. Другими словами, интерфейс и вспомогательная функция можно использовать взаимозаменяемо.

Требования

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

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

IRunnableObject

OleIsRunning