Metodo IUPnPDeviceFinderCallback::SearchComplete (upnp.h)
Il metodo SearchComplete viene richiamato dal framework UPnP per notificare all'applicazione che è stata completata la ricerca iniziale per i dispositivi di rete.
Questo metodo viene richiamato quando il framework UPnP ha completato l'invio di callback IUPnPDeviceFinderCallback::D eviceadded o IUPnPDeviceFinderAddCallbackWithInterface::D evicevicedWithInterface callback per tutti i dispositivi presenti nella rete al momento dell'avvio della ricerca. Questi callback riflettono lo stato della rete al momento dell'avvio della ricerca.
Sintassi
HRESULT SearchComplete(
[in] LONG lFindData
);
Parametri
[in] lFindData
Specifica la ricerca per cui il framework UPnP restituisce i risultati. Il valore di lFindData è il valore restituito al chiamante da IUPnPDeviceFinder::CreateAsyncFind.
Valore restituito
L'applicazione deve restituire S_OK.
Commenti
Questo metodo fornisce semplicemente informazioni. Non indica che la ricerca asincrona è stata terminata, ma piuttosto che il probe iniziale è stato completato. La ricerca asincrona continua a segnalare i dispositivi aggiunti alla rete e rimossi fino a quando l'applicazione chiama IUPnPDeviceFinder::CancelAsyncFind.
La ricerca iniziale può richiedere molto tempo per completare. Il callback SearchComplete viene richiamato quando il documento di descrizione per l'ultimo dispositivo trovato, ovvero l'ultimo dispositivo presente nella rete al momento dell'avvio della ricerca, è stato caricato o non è riuscito a caricare.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | upnp.h |
| DLL | Upnp.dll |