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

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

  • Статья

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

Синтаксис

HRESULT SearchById(
  [in]           LPCWSTR pszId,
  [in, optional] LPCWSTR pszTag
);

Параметры

[in] pszId

Идентификатор устройства нужного поставщика обнаружения.

[in, optional] pszTag

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

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

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

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

Комментарии

SearchById инициирует WS-Discovery Resolve в попытке найти ранее известное конкретное устройство. pszId используется в качестве адреса конечной точки в разрешении. Этот вызов может привести к добавлению одного или нескольких обратных вызовов. Если до завершения поиска выполняются какие-либо обратные вызовы Add , будет выдан обратный вызов SearchComplete ; в противном случае будет выполнен обратный вызов SearchFailed .

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

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

Требования

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

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

IWSDiscoveryProvider