通过

iWSDiscoveryProvider：：SearchById 方法 (wsddisco.h)

  • 项目

按设备标识符初始化 对 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 用作 Resolve 中的终结点地址。 此调用可能会导致一个或多个 Add 回调。 如果在搜索完成之前发出任何 添加 回调，则将发出 SearchComplete 回调;否则，将发出 SearchFailed 回调。

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

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

要求

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

另请参阅

IWSDiscoveryProvider