Skip to content

Latest commit

 

History

History
88 lines (66 loc) · 3.95 KB

nf-upnp-iupnpdevicefindercallback-deviceadded.md

File metadata and controls

88 lines (66 loc) · 3.95 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:upnp.IUPnPDeviceFinderCallback.DeviceAdded
IUPnPDeviceFinderCallback::DeviceAdded (upnp.h)
The DeviceAdded method is invoked by the UPnP framework to notify the application that a device has been added to the network.
DeviceAdded
DeviceAdded method [UPnP APIs]
DeviceAdded method [UPnP APIs]
IUPnPDeviceFinderCallback interface
IUPnPDeviceFinderCallback interface [UPnP APIs]
DeviceAdded method
IUPnPDeviceFinderCallback.DeviceAdded
IUPnPDeviceFinderCallback::DeviceAdded
_upnp_iupnpdevicefindercallback_deviceadded
upnp.iupnpdevicefindercallback_deviceadded
upnp/IUPnPDeviceFinderCallback::DeviceAdded
upnp\iupnpdevicefindercallback_deviceadded.htm
upnp
4a61ca43-cbc6-4db2-9706-23cadbae9c3e
12/05/2018
DeviceAdded, DeviceAdded method [UPnP APIs], DeviceAdded method [UPnP APIs],IUPnPDeviceFinderCallback interface, IUPnPDeviceFinderCallback interface [UPnP APIs],DeviceAdded method, IUPnPDeviceFinderCallback.DeviceAdded, IUPnPDeviceFinderCallback::DeviceAdded, _upnp_iupnpdevicefindercallback_deviceadded, upnp.iupnpdevicefindercallback_deviceadded, upnp/IUPnPDeviceFinderCallback::DeviceAdded
upnp.h
Windows
Windows XP [desktop apps only]
None supported
Upnp.dll
Windows
19H1
IUPnPDeviceFinderCallback::DeviceAdded
upnp/IUPnPDeviceFinderCallback::DeviceAdded
c++
APIRef
kbSyntax
COM
Upnp.dll
IUPnPDeviceFinderCallback.DeviceAdded

IUPnPDeviceFinderCallback::DeviceAdded

-description

The DeviceAdded method is invoked by the UPnP framework to notify the application that a device has been added to the network.

-parameters

-param lFindData [in]

Specifies the search for which the UPnP framework is returning results. The value of lFindData is the value returned to the caller by IUPnPDeviceFinder::CreateAsyncFind.

-param pDevice [in]

Reference to a IUPnPDevice object that contains the new device.

-returns

The UPnP framework does not expect the application to return any specific value; any value returned is ignored by the UPnP framework.

-remarks

The UPnP framework might call the IUPnPDeviceFinderAddCallbackWithInterface::DeviceAddedWithInterface method instead of DeviceAdded to notify the application when a device is added to the network. The UPnP framework will query to see if the IUPnPDeviceFinderAddCallbackWithInterface interface exists. If so, the UPnP framework will call DeviceAddedWithInterface. Otherwise, the UPnP framework will call DeviceAdded.

The UPnP framework might return two or more callbacks for the same device. This can happen if a device's IP address was changed without first removing the device, and then re-adding it to the network. If this occurs, an application should discard the old device and use the most recently returned one. An application checks for duplicate devices by comparing the UDNs.

-see-also

IUPnPDeviceFinder

IUPnPDeviceFinder::CreateAsyncFind

IUPnPDeviceFinderCallback