Compartir a través de

Método IMbnInterfaceEvents::OnScanNetworkComplete (mbnapi.h)

  • Artículo

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

Consulte también

IMbnInterfaceEvents