Метод IOleUILinkContainerW::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 при успешном завершении. Другие возможные возвращаемые значения включают следующее.
| Код возврата | Описание |
|---|---|
|
Недостаточно разрешений на доступ. |
|
Операция не удалась. |
|
Указанный идентификатор недопустим. |
|
Недостаточно доступной памяти для этой операции. |
Комментарии
Примечания к вызывающим абонентам
Вызовите этот метод, если для параметра fErrorMessage задано значение TRUE , если пользователь явно нажимает кнопку для обновления ссылки, то есть нажимает кнопку Обновить сейчас . Вызывайте его со значением FALSE в случаях, когда контейнер никогда не должен отображать сообщение об ошибке, то есть когда выполняется большой набор операций, а ошибка должна быть передана пользователю позже, как это может произойти с индикатором хода выполнения связей обновления . Вместо того чтобы предоставлять по одному сообщению для каждого сбоя, при условии, что есть сбои, предоставьте одно сообщение для всех сбоев в конце операции.Примечания для разработчиков
Для ссылок OLE вызовите IOleObject::Update.Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | oledlg.h |