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

Статья
08/25/2023

Обновления кэшированные данные составного документа для связанного объекта. Это включает привязку к источнику ссылки, если он еще не привязан.

Синтаксис

HRESULT Update(
  [in] IBindCtx *pbc
);

Параметры

[in] pbc

Указатель на интерфейс IBindCtx в контексте привязки, который будет использоваться при привязке источника ссылки. Этот параметр может принимать значение NULL. Контекст привязки кэширует объекты, привязанные к процессу привязки, содержит параметры, которые применяются ко всем операциям, использующим контекст привязки, и предоставляет средства, с помощью которых реализация привязки должна извлекать сведения о своей среде. Дополнительные сведения см. в разделе IBindCtx.

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

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

Код возврата	Описание
CACHE_E_NOCACHE_UPDATE	Операция привязки сработала, но кэши не были обновлены.
CACHE_S_SOMECACHES_NOTUPDATED	Операция привязки сработала, но не все кэши были обновлены.
OLE_E_CANT_BINDTOSOURCE	Не удается выполнить привязку к источнику ссылки.

Пользователь может обновить кэшированные данные для связанного объекта, нажав кнопку Обновить в диалоговом окне Ссылки . Если для отображения диалогового окна Ссылки используется функция OleUIEditLinks, необходимо реализовать интерфейс IOleUILinkContainer. Диалоговое окно вызывает реализации IOleUILinkContainer::UpdateLink, когда пользователь нажимает кнопку Обновить. Реализация этого метода может вызывать Update.

Приложение-контейнер также может вызвать Update для обновления связанного объекта, так как этот метод вызывает Update при вызове для связанного объекта.

Этот метод обновляет как автоматические, так и ручные ссылки. Для ручных ссылок единственным способом обновления кэша является вызов Update или Update . Дополнительные сведения об автоматических и ручных ссылках см. в разделе IOleLink::SetUpdateOptions.

Примечания по реализации

Если pbc не равно NULL, реализация Update связанного объекта вызывает IBindCtx::RegisterObjectBound для регистрации источника привязанной ссылки. Это гарантирует, что источник ссылки будет работать до тех пор, пока контекст привязки не будет освобожден.

Текущие кэши остаются без изменений, если не удается привязать источник ссылки.

Требования

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