IWSDiscoveryProviderNotify：：SearchFailed 方法 (wsddisco.h)
调用 以指示用户启动的搜索失败。
语法
HRESULT SearchFailed(
[in] HRESULT hr,
[in, optional] LPCWSTR pszTag
);
参数
[in] hr
启动此回调的搜索失败的原因。 值 S_FALSE 指示搜索已完成，但不发出任何添加回调。
[in, optional] pszTag
此搜索的可选标识符标记。 可以为 NULL。
返回值
返回值没有意义。 实施者应返回 S_OK。
注解
如果成功收到任何响应，则调用 SearchComplete。
如果用户启动的查询不会导致响应，则调用 SearchFailed。 在这种情况下，将S_FALSE hr 参数的值。 如果尝试传输查询时出现错误，可以选择调用 SearchFailed，因为查询传输不一定是同步的。 pszTag 将与查询中用户提供的标记匹配，并应用于确定哪个查询失败。
使用 SearchByType 或 SearchById 启动搜索与接收 SearchFailed 通知之间的间隔最长为 10 秒，具体取决于 WS-Discovery 的MATCH_TIMEOUT，并由 DPWS 附录 I 修改。使用 SearchByAddress 启动搜索和收到 SearchFailed 通知之间的间隔通常为 21 秒，但最长可以为 150 秒。
注意 提供程序可能会同时对 SearchFailed 进行多次调用，因此必须在此回调中同步共享数据。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | wsddisco.h (包括 Wsdapi.h) |
| DLL | Wsdapi.dll |