Метод IOleCacheControl::OnRun (oleidl.h)
Уведомляет кэш о том, что объект источника данных перешел в состояние выполнения, чтобы объект кэша при необходимости смог установить приемники рекомендаций.
Синтаксис
HRESULT OnRun(
[in] LPDATAOBJECT pDataObject
);
Параметры
[in] pDataObject
Указатель на интерфейс IDataObject объекта, который входит в состояние выполнения.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении. Другие возможные возвращаемые значения включают следующее.
Код возврата | Описание |
---|---|
|
Один из аргументов недопустим. |
|
Произошла непредвиденная ошибка. |
|
Для этой операции недостаточно памяти. |
Комментарии
При вызове 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 |