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

Метод IWSDiscoveryProvider::SearchByAddress (wsddisco.h)

  • Статья

Инициализирует поиск узлов WS-Discovery по адресу устройства.

Синтаксис

HRESULT SearchByAddress(
  [in]           LPCWSTR pszAddress,
  [in, optional] LPCWSTR pszTag
);

Параметры

[in] pszAddress

Транспортный http-адрес устройства.

[in, optional] pszTag

Необязательный тег идентификатора для этого поиска. Может иметь значение NULL.

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

Возможные возвращаемые значения включают, помимо прочего, следующие:

Код возврата Описание
S_OK
 Метод успешно завершен.
E_INVALIDARG
 pszAddress имеет значение NULL, длина символов pszAddress превышает WSD_MAX_TEXT_LENGTH (8192), а длина символов pszTag превышает WSD_MAX_TEXT_LENGTH (8192).
E_ABORT
 Интерфейс обратного вызова не подключен. Перед вызовом этого метода необходимо вызвать Attach .
E_OUTOFMEMORY
 Недостаточно памяти для выполнения операции.

Комментарии

SearchByAddress инициирует пробу WS-Discovery по протоколу HTTP в попытке идентифицировать устройство по известному URL-адресу. Проба отправляется по адресу, указанному pszAddress. Этот вызов может привести к одному или нескольким обратным вызовам Add . Если какие-либо обратные вызовы Add выполняются до завершения поиска, будет выполнен обратный вызов SearchComplete ; В противном случае будет выполнен обратный вызов SearchFailed . Интервал между инициализацией поиска и получением любого из этих уведомлений может составлять до 30 секунд.

pszTag — это дополнительная строка, предоставляемая пользователем, которая будет отправляться обратно в любом обратном вызове, что позволяет вызывающему объекту связать обратный вызов с исходным запросом.

Сведения об устранении неполадок приложений, вызывающих этот метод, см. в статье Устранение неполадок с приложениями WSDAPI.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header wsddisco.h (включая Wsdapi.h)
DLL Wsdapi.dll

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

IWSDiscoveryProvider