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

Статья
08/25/2023

Указывает, как часто связанный объект должен обновлять свои кэшированные данные.

Синтаксис

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

Параметры

[in] dwUpdateOpt

Указывает, как часто связанный объект должен обновлять свои кэшированные данные. Возможные значения для dwUpdateOpt взяты из перечисления OLEUPDATE.

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

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

Код возврата	Описание
E_INVALIDARG	Предоставленное значение является недопустимым.

Пользователь выбирает параметр обновления для связанного объекта с помощью диалогового окна Ссылки . Если для отображения этого диалогового окна используется функция OleUIEditLinks , необходимо реализовать интерфейс IOleUILinkContainer . Диалоговое окно вызывает метод IOleUILinkContainer::SetLinkUpdateOptions , чтобы указать параметр обновления, выбранный конечным пользователем. Реализация этого метода должна вызывать метод IOleLink::SetUpdateOptions , чтобы передать выбранный параметр связанному объекту.

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

Параметр обновления по умолчанию — OLEUDPATE_ALWAYS. Реализация IPersistStorage::Save в связанном объекте сохраняет текущий параметр обновления.

Если в качестве параметра обновления указан OLEUDPATE_ALWAYS, связанный объект обновляет кэши ссылки в следующих ситуациях:

Если параметр обновления изменяется с ручного на автоматический, если источник ссылки запущен.
Всякий раз, когда связанный объект привязывается к источнику ссылки.
Каждый раз, когда выполняется источник ссылки и вызываются реализации IOleObject::Close, IPersistStorage::Save или IAdviseSink::OnSave .

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

Требования

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