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

DeviceAdded 方法由 UPnP 框架调用,以通知应用程序设备已添加到网络。

语法

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 来检查重复设备。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 upnp.h
DLL Upnp.dll

另请参阅

IUPnPDeviceFinder

IUPnPDeviceFinder::CreateAsyncFind

IUPnPDeviceFinderCallback