IUPnPDeviceFinderAddCallbackWithInterface::DeviceAddedWithInterface method (upnp.h)

Article
02/22/2024

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

Syntax

HRESULT DeviceAddedWithInterface(
  [in] LONG        lFindData,
  [in] IUPnPDevice *pDevice,
  [in] GUID        *pguidInterface
);

Parameters

[in] lFindData

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.

[in] pDevice

Pointer to a IUPnPDevice object that contains the new device.

[in] pguidInterface

GUID of the network adapter through which the device advertisement came.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the method returns one of the COM error codes defined in WinError.h.

Remarks

The UPnP framework will query to see if the IUPnPDeviceFinderAddCallbackWithInterface interface exists. If you have implemented the interface, the UPnP framework will call the DeviceAddedWithInterface method. Otherwise, the UPnP framework will call the IUPnPDeviceFinderCallback::DeviceAdded method.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	None supported
Target Platform	Windows
Header	upnp.h
DLL	Upnp.dll