Compartir a través de

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

Examina de forma asincrónica la red para obtener una lista de proveedores visibles.

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 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.

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 IMbnInterface 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 IMbnInterfaceEvents 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 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

IMbnInterface