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

Статья
08/28/2023

Инициализирует поиск узлов 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

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