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


Метод IOleObject::Update (oleidl.h)

Обновления кэши данных или представлений обработчика объекта или связывания.

Синтаксис

HRESULT Update();

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

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

Код возврата Описание
E_FAIL
Операция не удалась.
OLE_E_CANT_BINDTOSOURCE
Не удается запустить объект для получения обновленных данных. Объект по какой-либо причине недоступен вызывающей.
CACHE_E_NOCACHE_UPDATED
Кэши не были обновлены.
CACHE_S_SOMECACHES_NOTUPDATED
Некоторые кэши не были обновлены.

Комментарии

Метод Update позволяет контейнерам обновлять данные в связанных и внедренных объектах. Объект ссылки может стать устаревшим, если источник ссылки был обновлен. Внедренный объект, содержащий ссылки на другие объекты, также может стать устаревшим. Внедренный объект, не содержащий ссылок, не может устареть, так как его данные не связаны с другим источником.

Примечания для разработчиков

Когда контейнер вызывает метод IOleObject::Update объекта ссылки, объект ссылки находит источник ссылки и получает из него новую презентацию. Этот процесс также может включать запуск одного или нескольких объектных приложений, что может занять много времени.

Когда контейнер вызывает метод IOleObject::Update внедренного объекта, он запрашивает у объекта обновление всех объектов ссылок, которые он может содержать. В ответ обработчик объектов рекурсивно вызывает IOleObject::Update для каждого из своих связанных объектов, выполняя каждый из них по мере необходимости.

Требования

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

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

IOleObject

IOleObject::IsUpToDate