IUPnPDeviceFinderCallback：:D eviceAdded 方法 (upnp.h)

UPnP 架構會叫用 DeviceAdded 方法，以通知應用程式裝置已新增至網路。

語法

HRESULT DeviceAdded(
  [in] LONG        lFindData,
  [in] IUPnPDevice *pDevice
);

[in] lFindData

指定UPnP架構傳回結果的搜尋。 lFindData 的值是由 IUPnPDeviceFinder：：CreateAsyncFind 傳回給呼叫端的值。

[in] pDevice

包含新裝置的 IUPnPDevice 對象的參考。

UPnP 架構不預期應用程式傳回任何特定值;UPnP 架構會忽略傳回的任何值。

UPnP 架構可能會呼叫 IUPnPDeviceFinderAddCallbackWithInterface：:D eviceAddedWithInterface 方法，而不是 DeviceAdded ，以在裝置新增至網路時通知應用程式。 UPnP 架構會查詢，以查看 IUPnPDeviceFinderAddCallbackWithInterface 介面是否存在。如果是，UPnP 架構會呼叫 DeviceAddedWithInterface。否則，UPnP 架構會呼叫 DeviceAdded。

UPnP 架構可能會傳回相同裝置的兩個或多個回呼。如果裝置的IP位址已變更，而不需要先移除裝置，然後重新新增至網路，就會發生這種情況。如果發生這種情況，應用程式應該捨棄舊的裝置，並使用最近傳回的裝置。應用程式會藉由比較 UDN 來檢查重複的裝置。