IUPnPDeviceFinderCallback ::D eviceAdded, méthode (upnp.h)
La méthode DeviceAdded est appelée par l’infrastructure UPnP pour informer l’application qu’un appareil a été ajouté au réseau.
Syntaxe
HRESULT DeviceAdded(
[in] LONG lFindData,
[in] IUPnPDevice *pDevice
);
Paramètres
[in] lFindData
Spécifie la recherche pour laquelle l’infrastructure UPnP retourne des résultats. La valeur de lFindData est la valeur retournée à l’appelant par IUPnPDeviceFinder ::CreateAsyncFind.
[in] pDevice
Référence à un objet IUPnPDevice qui contient le nouvel appareil.
Valeur retournée
L’infrastructure UPnP ne s’attend pas à ce que l’application retourne une valeur spécifique ; toute valeur retournée est ignorée par l’infrastructure UPnP.
Remarques
L’infrastructure UPnP peut appeler la méthode IUPnPDeviceFinderAddCallbackWithInterface ::D eviceAddedWithInterface au lieu de DeviceAdded pour avertir l’application lorsqu’un appareil est ajouté au réseau. L’infrastructure UPnP interroge pour voir si l’interface IUPnPDeviceFinderAddCallbackWithInterface existe. Dans ce cas, l’infrastructure UPnP appelleRa DeviceAddedWithInterface. Sinon, l’infrastructure UPnP appelleRa DeviceAdded.
L’infrastructure UPnP peut retourner au moins deux rappels pour le même appareil. Cela peut se produire si l’adresse IP d’un appareil a été modifiée sans le supprimer d’abord, puis le rajouter au réseau. Si cela se produit, une application doit ignorer l’ancien appareil et utiliser le dernier appareil retourné. Une application vérifie la présence d’appareils en double en comparant les noms définis par l’utilisateur.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | upnp.h |
| DLL | Upnp.dll |