IUPnPDeviceFinderCallback::DeviceAdded

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

HRESULT DeviceAdded(
  LONG lFindData,
  IUPnPDevice* pDevice
);

Parameters

• lFindData
  [in] Specifies the search for which UPnP is returning results. The value of lFindData is the value returned to the caller by IUPnPDeviceFinder::CreateAsyncFind.
• pDevice
  [in] Reference to an IUPnPDevice:IDispatch object that contains the new device.

Return Values

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 UDNs.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Upnp.h.
Link Library: Uuid.lib.

See Also

IUPnPDeviceFinder:IDispatch | IUPnPDeviceFinder::CreateAsyncFind

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.