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

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

  • Статья

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

Синтаксис

HRESULT SearchByType(
  [in, optional] const WSD_NAME_LIST *pTypesList,
  [in, optional] const WSD_URI_LIST  *pScopesList,
  [in, optional] LPCWSTR             pszMatchBy,
  [in, optional] LPCWSTR             pszTag
);

Параметры

[in, optional] pTypesList

Указатель на структуру WSD_NAME_LIST , представляющую список типов поставщиков обнаружения для поиска. Может иметь значение NULL.

[in, optional] pScopesList

Указатель на структуру WSD_URI_LIST , представляющую список областей поставщика обнаружения для поиска. Может иметь значение NULL.

[in, optional] pszMatchBy

Правило сопоставления, используемое для областей. Может иметь значение NULL.

[in, optional] pszTag

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

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

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

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

Комментарии

SearchByType инициирует пробу WS-Discovery, пытаясь найти узлы обнаружения, соответствующие указанным критериям. Этот метод позволяет сопоставлять по типам, областям, некоторому сочетанию двух или сопоставлять все устройства, поддерживающие обнаружение (если области или типы не указаны).

pszMatchBy следует предоставлять только в том случае, если также предоставлен pScopesList . Этот вызов может привести к одному или нескольким обратным вызовам Add . Если какие-либо обратные вызовы Add выполняются до завершения поиска, будет выполнен обратный вызов SearchComplete ; В противном случае будет выполнен обратный вызов SearchFailed .

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

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

Требования

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

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

IWSDiscoveryProvider