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


Метод IOleCacheControl::OnRun (oleidl.h)

Уведомляет кэш о том, что объект источника данных перешел в состояние выполнения, чтобы объект кэша при необходимости смог установить приемники рекомендаций.

Синтаксис

HRESULT OnRun(
  [in] LPDATAOBJECT pDataObject
);

Параметры

[in] pDataObject

Указатель на интерфейс IDataObject объекта, который входит в состояние выполнения.

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

Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.

Код возврата Описание
E_INVALIDARG
Один из аргументов недопустим.
E_UNEXPECTED
Произошла непредвиденная ошибка.
E_OUTOFMEMORY
Для этой операции недостаточно памяти.

Комментарии

При вызове OnRun кэш при необходимости настраивает консультативные подключения к исходному объекту данных, чтобы получать уведомления. Консультативное соединение, созданное между запущенным объектом и кэшем, уничтожается при вызове метода IOleCacheControl::OnStop .

Некоторые обработчики объектов или внутрипроцессные серверы могут использовать кэш пассивно, а не вызывать OnRun. Эти приложения должны вызывать IOleCache2::UpdateCache, IOleCache::InitCache или IOleCache::SetData , чтобы при необходимости заполнить кэш, чтобы обеспечить обновление кэша.

OnRun не добавляет счетчик ссылок на указатель на IDataObject, переданный в pDataObject. Так как вызывающий объект OleRun отвечает за то, чтобы время существования указателя pDataObject продолжалось до вызова OnStop , вызывающий объект должен содержать указатель на IDataObject в интересующем объекте данных.

Требования

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

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

IOleCache2::UpdateCache

IOleCacheControl

IOleCacheControl::OnStop