Metodo IUPnPDeviceFinderCallback::D eviceAdded (upnp.h)
Il metodo DeviceAdded viene richiamato dal framework UPnP per notificare all'applicazione che un dispositivo è stato aggiunto alla rete.
Sintassi
HRESULT DeviceAdded(
[in] LONG lFindData,
[in] IUPnPDevice *pDevice
);
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.
[in] pDevice
Riferimento a un oggetto IUPnPDevice contenente il nuovo dispositivo.
Valore restituito
Il framework UPnP non prevede che l'applicazione restituisca alcun valore specifico; qualsiasi valore restituito viene ignorato dal framework UPnP.
Commenti
Il framework UPnP potrebbe chiamare il metodo IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface anziché DeviceAdded per notificare all'applicazione quando un dispositivo viene aggiunto alla rete. Il framework UPnP eseguirà una query per verificare se esiste l'interfaccia IUPnPDeviceFinderAddCallbackWithInterface . In tal caso, il framework UPnP chiamerà DeviceAddedWithInterface. In caso contrario, il framework UPnP chiamerà DeviceAdded.
Il framework UPnP potrebbe restituire due o più callback per lo stesso dispositivo. Ciò può verificarsi se l'indirizzo IP di un dispositivo è stato modificato senza prima rimuovere il dispositivo e quindi aggiungerlo nuovamente alla rete. In questo caso, un'applicazione deve eliminare il dispositivo precedente e usare quello restituito più di recente. Un'applicazione verifica i dispositivi duplicati confrontando i nomi dell'utente.
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 |