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 |