IUPnPDeviceFinderCallback::SearchComplete 方法 (upnp.h)
UPnP 框架调用 SearchComplete 方法,以通知应用程序网络设备的初始搜索已完成。
当 UPnP 框架完成发送 IUPnPDeviceFinderCallback::D eviceAdded 或 IUPnPDeviceFinderAddCallbackWithInterface::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 |