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 |