IUPnPDeviceFinder::FindByType 方法 (upnp.h)

FindByType 方法按设备类型或服务类型同步搜索设备。

语法

HRESULT FindByType(
  [in]  BSTR         bstrTypeURI,
  [in]  DWORD        dwFlags,
  [out] IUPnPDevices **pDevices
);

参数

[in] bstrTypeURI

指定要搜索的设备或服务类型的类型 URI。

[in] dwFlags

必须为零。 此参数留待将来使用。

[out] pDevices

接收对找到的 IUPnPDevices 设备集合的引用。

返回值

如果方法成功,则返回值S_OK。 否则,方法将返回 WinError.h 中定义的 COM 错误代码之一。

注解

在搜索完成之前,此方法不会返回 。 搜索可能需要至少 9 秒的时间,甚至可能更多。 不得从处理用户界面消息的线程调用此方法。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 upnp.h
DLL Upnp.dll

另请参阅

IUPnPDeviceFinder

IUPnPDeviceFinder::FindByUDN

IUPnPDevices