IUPnPDeviceFinderCallback::SearchComplete 方法 (upnp.h)

UPnP 框架调用 SearchComplete 方法,以通知应用程序网络设备的初始搜索已完成。

当 UPnP 框架完成发送 IUPnPDeviceFinderCallback::D eviceAddedIUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface 回调时,将调用此方法。 这些回调反映网络在开始搜索时的状态。

语法

HRESULT SearchComplete(
  [in] LONG lFindData
);

参数

[in] lFindData

指定 UPnP 框架为其返回结果的搜索。 lFindData 的值是由 IUPnPDeviceFinder::CreateAsyncFind 返回给调用方的值。

返回值

应用程序应返回S_OK。

注解

此方法只是提供信息。 它并不表示异步搜索已结束,而是表示初始探测已完成。 异步搜索会继续报告要添加到网络和从网络中删除的设备,直到应用程序调用 IUPnPDeviceFinder::CancelAsyncFind

初始搜索可能需要很长时间才能完成。 当找到的最后一个设备的说明文档 (即,在开始搜索时找到的最后一个设备) 已加载或无法加载时,将调用 SearchComplete 回调。

要求

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

另请参阅

IUPnPDeviceFinder

IUPnPDeviceFinder::CreateAsyncFind

IUPnPDeviceFinderCallback