Método IUPnPDeviceFinderCallback::SearchComplete (upnp.h)
El marco UPnP invoca el método SearchComplete para notificar a la aplicación que se ha completado la búsqueda inicial de dispositivos de red.
Este método se invoca cuando el marco UPnP ha terminado de enviar devoluciones de llamada IUPnPDeviceFinderCallback::D eviceAdded o IUPnPDeviceFinderAddCallbackWithInterface::D eviceAddedWithInterface para todos los dispositivos presentes en la red en el momento en que se inició la búsqueda. Estas devoluciones de llamada reflejan el estado de la red en el momento en que se inició la búsqueda.
Sintaxis
HRESULT SearchComplete(
[in] LONG lFindData
);
Parámetros
[in] lFindData
Especifica la búsqueda para la que el marco UPnP devuelve resultados. El valor de lFindData es el valor devuelto al autor de la llamada por IUPnPDeviceFinder::CreateAsyncFind.
Valor devuelto
La aplicación debe devolver S_OK.
Comentarios
Este método simplemente proporciona información. No indica que la búsqueda asincrónica ha finalizado, sino que se ha completado el sondeo inicial. La búsqueda asincrónica sigue notificando los dispositivos que se agregan y quitan de la red hasta que la aplicación llama a IUPnPDeviceFinder::CancelAsyncFind.
La búsqueda inicial puede tardar mucho tiempo en completarse. La devolución de llamada SearchComplete se invoca cuando el documento de descripción del último dispositivo encontrado (es decir, el último dispositivo encontrado en la red en el momento en que se inició la búsqueda) se ha cargado o no se ha podido cargar.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
Servidor mínimo compatible | No se admite ninguno |
Plataforma de destino | Windows |
Encabezado | upnp.h |
Archivo DLL | Upnp.dll |