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

Voir aussi

IUPnPDeviceFinder

IUPnPDeviceFinder ::CreateAsyncFind

IUPnPDeviceFinderCallback