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

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

  • Статья

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

Синтаксис

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR 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