Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method is invoked when a device has been added to the network.

Syntax 

HRESULT DeviceAdded(
  LONG 
lFindData,
  IUPnPDevice* 
pDevice
);

Parameters

lFindData

[in] Specifies the search for which UPnP is returning results. The value of lFindDatais the value returned to the caller by IUPnPDeviceFinder::CreateAsyncFind.

pDevice

[in] Reference to an IUPnPDevice:IDispatchobject that contains the new device.

Return Value

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

Remarks

UPnP may 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 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 can check for duplicate devices by comparing the unique device name (UDN) fields of each device.

Requirements

Header upnp.h
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also