通过

IWSDiscoveryProvider：：SearchByAddress 方法 (wsddisco.h)

  • 项目

按设备地址初始化 对 WS 发现 主机的搜索。

语法

HRESULT SearchByAddress(
  [in]           LPCWSTR pszAddress,
  [in, optional] LPCWSTR pszTag
);

参数

[in] pszAddress

设备的 HTTP 传输地址。

[in, optional] pszTag

此搜索的可选标识符标记。 可以为 NULL。

返回值

可能的返回值包括但不限于以下值：

返回代码 说明
S_OK
 方法已成功完成。
E_INVALIDARG
 pszAddress 为 NULL，pszAddress 的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) ，或者 pszTag 的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) 。
E_ABORT
 尚未附加回调接口。 在调用此方法之前，必须调用 Attach 。
E_OUTOFMEMORY
 内存不足，无法执行操作。

注解

SearchByAddress 通过 HTTP 启动 WS-Discovery 探测 ，以尝试识别已知 URL 中的设备。 探测将发送到 pszAddress 指定的地址。 此调用可能会导致一个或多个 Add 回调。 如果在搜索完成之前发出任何 添加 回调，则将发出 SearchComplete 回调;否则，将发出 SearchFailed 回调。 启动搜索和接收其中任一通知之间的间隔最长为 30 秒。

pszTag 是用户提供的可选字符串，将在任一回调中反馈，使调用方能够将回调与原始查询相关联。

有关对调用此方法的应用程序进行故障排除的信息，请参阅 WSDAPI 应用程序疑难解答。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wsddisco.h (包括 Wsdapi.h)
DLL Wsdapi.dll

另请参阅

IWSDiscoveryProvider