Метод IOleUILinkContainerA::UpdateLink (oledlg.h)

Принудительное подключение выбранных ссылок к источнику и получение текущих сведений.

Синтаксис

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

Параметры

[in] dwLink

Определяемый контейнером уникальный идентификатор для одной ссылки. Контейнеры могут использовать указатель на сайт контейнера ссылки для этого значения.

[in] fErrorMessage

Определяет, должен ли вызывающий объект (реализующий IOleUILinkContainer) отображать сообщение об ошибке при сбое обновления ссылки. В диалоговом окне Обновление ссылок для этого параметра задано значение FALSE. В диалоговых окнах Свойства объекта и связи для него задано значение TRUE.

[in] fReserved

Этот параметр зарезервирован и должен иметь значение FALSE.

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

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

Код возврата	Описание
E_ACCESSDENIED	Недостаточно разрешений доступа.
E_FAIL	Операция не удалась.
E_INVALIDARG	Указанный идентификатор недопустим.
E_OUTOFMEMORY	Для этой операции недостаточно памяти.

Комментарии

Примечания к вызывающим абонентам

Вызовите этот метод, если для параметра fErrorMessage задано значение TRUE , если пользователь явно нажимает кнопку, чтобы обновить ссылку, то есть нажимает кнопку "Обновить сейчас ". Вызовите его со значением FALSE в случаях, когда контейнер никогда не должен отображать сообщение об ошибке, т. е. когда выполняется большой набор операций, а ошибка должна быть распространена на пользователя позже, как это может произойти с индикатором хода выполнения связей обновления . Вместо того, чтобы предоставлять по одному сообщению для каждого сбоя, если есть сбои, предоставьте одно сообщение для всех сбоев в конце операции.

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

Для ссылок OLE вызовите IOleObject::Update.

Требования

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

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

IOleObject::Update

IOleUILinkContainer