Método IMbnInterfaceEvents::OnScanNetworkComplete (mbnapi.h)
Importante
A partir de Windows 10, versión 1803, las API de Win32 descritas en esta sección se reemplazan por las API de Windows Runtime en el espacio de nombres Windows.Networking.Connectivity.
El servicio de banda ancha móvil llama a este método de notificación para indicar la finalización de un examen de red.
Sintaxis
HRESULT OnScanNetworkComplete(
[in] IMbnInterface *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Parámetros
[in] newInterface
IMbnInterface que representa un dispositivo en el que se realizó esta operación.
[in] requestID
Identificador de solicitud asignado por el servicio de banda ancha móvil para esta notificación.
[in] status
Estado de finalización de la operación
Una aplicación que llama puede esperar uno de los valores siguientes.
S_OK
La operación se realizó correctamente.
E_MBN_RADIO_POWER_OFF
No se puede obtener una lista de red visible porque la radio del dispositivo está desactivada. La aplicación puede emitir una solicitud de examen de red cuando obtiene la notificación de radio activada.
E_MBN_DEVICE_BUSY
El dispositivo está ocupado y no puede realizar actualmente una operación de examen de red. Esto lo devuelven los dispositivos que no admiten una operación de examen de red cuando tiene establecida una conexión de datos.
E_MBN_ALREADY_ACTIVE
Ya hay una operación de examen de red en curso.
Valor devuelto
Este método debe devolver S_OK.
Comentarios
Si la operación se completó correctamente, es decir, cuando el estado es S_OK, el servicio de banda ancha móvil actualizó correctamente la lista almacenada en caché de proveedores visibles. Después, una aplicación puede llamar al método GetVisibleProviders del IMbnInterface pasado para obtener la lista de proveedores visibles.
Si hay varias aplicaciones registradas para notificaciones, se llamará a este método en todas las aplicaciones registradas. Esto significa que una aplicación que no inició la operación de actualización recibirá una notificación.
Requisitos
| Cliente mínimo compatible | Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | mbnapi.h |