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

Метод IWSDiscoveryProviderNotify::SearchFailed (wsddisco.h)

  • Статья

Вызывается, чтобы указать, что поиск, инициированный пользователем, завершился сбоем.

Синтаксис

HRESULT SearchFailed(
  [in]           HRESULT hr,
  [in, optional] LPCWSTR pszTag
);

Параметры

[in] hr

Причина сбоя поиска, который инициировал этот обратный вызов. Значение S_FALSE указывает, что поиск завершен без выполнения обратных вызовов add.

[in, optional] pszTag

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

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

Возвращаемое значение не имеет смысла. Реализующий объект должен возвращать S_OK.

Комментарии

SearchComplete вызывается, если какие-либо ответы были успешно получены.

SearchFailed вызывается, если запрос, инициированный пользователем, не приводит к ответу. В этом случае значение параметра hr будет S_FALSE. При необходимости можно вызвать SearchFailed, если при попытке передачи запроса возникают ошибки, так как передача запроса не обязательно синхронная. pszTag будет соответствовать предоставленному пользователем тегу из запроса и должен использоваться для определения того, какой запрос завершился сбоем.

Интервал между инициализацией поиска с помощью SearchByType или SearchById и получением уведомления SearchFailed составляет не более 10 секунд на основе MATCH_TIMEOUT из WS-Discovery и измененных Приложением I к DPWS. Интервал между инициализацией поиска с помощью SearchByAddress и получением уведомления SearchFailed обычно составляет 21 секунду, но может составлять не более 150 секунд.

Примечание Поставщик может выполнять несколько одновременных вызовов searchFailed , поэтому важно синхронизировать общие данные в этом обратном вызове.
 

Требования

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

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

IWSDiscoveryProviderNotify