IUPnPDeviceFinderCallback::D eviceAdded-Methode (upnp.h)
Die DeviceAdded-Methode wird vom UPnP-Framework aufgerufen, um die Anwendung zu benachrichtigen, dass dem Netzwerk ein Gerät hinzugefügt wurde.
Syntax
HRESULT DeviceAdded(
[in] LONG lFindData,
[in] IUPnPDevice *pDevice
);
Parameter
[in] lFindData
Gibt die Suche an, für die das UPnP-Framework Ergebnisse zurückgibt. Der Wert von lFindData ist der Wert, der von IUPnPDeviceFinder::CreateAsyncFind an den Aufrufer zurückgegeben wird.
[in] pDevice
Verweis auf ein IUPnPDevice-Objekt , das das neue Gerät enthält.
Rückgabewert
Das UPnP-Framework erwartet nicht, dass die Anwendung einen bestimmten Wert zurückgibt. alle zurückgegebenen Werte werden vom UPnP-Framework ignoriert.
Hinweise
Das UPnP-Framework kann die IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface-Methode anstelle von DeviceAdded aufrufen, um die Anwendung zu benachrichtigen, wenn ein Gerät dem Netzwerk hinzugefügt wird. Das UPnP-Framework fragt ab, ob die IUPnPDeviceFinderAddCallbackWithInterface-Schnittstelle vorhanden ist. Wenn ja, ruft das UPnP-Framework DeviceAddedWithInterface auf. Andernfalls ruft das UPnP-Framework DeviceAdded auf.
Das UPnP-Framework gibt möglicherweise zwei oder mehr Rückrufe für dasselbe Gerät zurück. Dies kann passieren, wenn die IP-Adresse eines Geräts geändert wurde, ohne zuerst das Gerät zu entfernen und es dann erneut zum Netzwerk hinzuzufügen. In diesem Fall sollte eine Anwendung das alte Gerät verwerfen und das zuletzt zurückgegebene Gerät verwenden. Eine Anwendung sucht nach doppelten Geräten, indem sie die UDNs vergleicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | upnp.h |
| DLL | Upnp.dll |