Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Принудительное подключение выбранных ссылок к источнику и получение текущих сведений.
Синтаксис
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 |