Метод IUPnPDeviceFinderCallback::SearchComplete (upnp.h)
Метод SearchComplete вызывается платформой UPnP для уведомления приложения о завершении первоначального поиска сетевых устройств.
Этот метод вызывается, когда платформа UPnP завершает отправку обратных вызовов IUPnPDeviceFinderCallback::D eviceAdded или IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface для всех устройств, которые присутствовали в сети на момент запуска поиска. Эти обратные вызовы отражают состояние сети на момент начала поиска.
Синтаксис
HRESULT SearchComplete(
[in] LONG lFindData
);
Параметры
[in] lFindData
Указывает поиск, для которого платформа UPnP возвращает результаты. Значение lFindData — это значение, возвращаемое вызывающей объекту методом IUPnPDeviceFinder::CreateAsyncFind.
Возвращаемое значение
Приложение должно вернуть S_OK.
Комментарии
Этот метод просто предоставляет сведения. Он не указывает на то, что асинхронный поиск завершен, а на то, что начальная проба завершена. Асинхронный поиск продолжает сообщать об устройствах, добавленных в сеть и удаленных из нее, пока приложение не вызовет IUPnPDeviceFinder::CancelAsyncFind.
Начальный поиск может занять много времени. Обратный вызов SearchComplete вызывается, когда документ описания последнего найденного устройства (т. е. последнего устройства, обнаруженного в сети на момент начала поиска), был загружен или не удалось загрузить.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | upnp.h |
| DLL | Upnp.dll |