Método IMbnMultiCarrier::ScanNetwork (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.

Examina la red para obtener una lista de proveedores visibles para un dispositivo de varios operadores.

Sintaxis

HRESULT ScanNetwork(
  [out] ULONG *requestID
);

Parámetros

[out] requestID

Puntero al identificador de solicitud establecido por el sistema operativo para esta solicitud. La respuesta asincrónica de OnScanNetworkComplete contendrá este mismo requestID.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	El servicio de banda ancha móvil no se está ejecutando en este sistema.
E_HANDLE	La interfaz no es válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	La interfaz no es válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	El dispositivo no admite la operación. Los dispositivos que no admiten varios operadores pueden devolverlo.

Comentarios

Este método inicia una operación de examen de red. Cuando se completa correctamente, rellena la memoria caché del sistema operativo de proveedores y aplicaciones visibles puede llamar al método GetVisibleProviders de IMbnMultiCarrier para obtener una lista de redes visibles.

Se trata de una operación que consume mucho tiempo. Por lo tanto, las aplicaciones deben llamar primero a GetVisibleProviders y deben llamar a ScanNetwork solo cuando la información almacenada en caché es antigua.

Se trata de una operación asincrónica y ScanNetwork se devolverá inmediatamente. Si este método devuelve correctamente (con S_OK), después de completar la operación de examen, el sistema operativo llamará al método OnScanNetworkComplete de IMbnMultiCarrierEvents para notificar a la aplicación la finalización de la operación.

Si el dispositivo se quita del sistema antes de que se complete esta operación, no hay ninguna garantía de que la aplicación reciba la notificación de finalización.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	mbnapi.h

Consulte también

IMbnMultiCarrier