Поделиться через

Метод IOleUILinkContainerW::SetLinkSource (oledlg.h)

  • Статья

Изменяет источник ссылки.

Синтаксис

HRESULT SetLinkSource(
  [in]  DWORD  dwLink,
  [in]  LPWSTR lpszDisplayName,
  [in]  ULONG  lenFileName,
  [out] ULONG  *pchEaten,
  [in]  BOOL   fValidateSource
);

Параметры

[in] dwLink

Определяемый контейнером уникальный идентификатор для одной ссылки. См. раздел IOleUILinkContainer::GetNextLink.

[in] lpszDisplayName

Указатель на новую исходную строку для анализа.

[in] lenFileName

Длина начальной части имени файла строки lpszDisplayName . Если источник ссылки не хранится в файле, значение lenFileName должно иметь значение 0. Для ссылок OLE вызовите IOleLink::GetSourceDisplayName.

[out] pchEaten

Указатель на количество успешно проанализированных символов в lpszDisplayName.

[in] fValidateSource

ЗНАЧЕНИЕ TRUE , если моникер должен быть проверен; Для ссылок OLE необходимо вызвать MkParseDisplayName . FALSE , если моникер не должен проверяться. Если это возможно, ссылка должна принять неоцененный источник и пометить себя как недоступный.

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

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

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

Комментарии

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

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

Требования

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

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

IOleUILinkContainer

MkParseDisplayName