Метод 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-адрес устройства был изменен без предварительного удаления устройства, а затем повторного добавления его в сеть. В этом случае приложение должно удалить старое устройство и использовать последнее возвращенное устройство. Приложение проверяет наличие повторяющихся устройств путем сравнения определяемых пользователем имен.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnp.h |
| DLL | Upnp.dll |