Compartir a través de

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

Obtiene la lista de proveedores visibles.

Sintaxis

HRESULT GetVisibleProviders(
  [out, retval] ULONG     *age,
  [out, retval] SAFEARRAY **visibleProviders
);

Parámetros

[out, retval] age

Puntero al tiempo en segundos desde la última actualización de la lista de proveedores visibles del dispositivo.

[out, retval] visibleProviders

Puntero a una matriz de estructuras de MBN_PROVIDER que contiene la lista de proveedores para la interfaz. Si este método devuelve cualquier valor distinto de S_OK, este parámetro es NULL. De lo contrario, al finalizar, el programa de llamada debe liberar la memoria asignada llamando a SafeArrayDestroy.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente. visibleProviders contiene valores válidos . En función de la antigüedad de la información, la aplicación que realiza la llamada puede decidir emitir una nueva llamada a ScanNetwork.
E_PENDING
 La información no está disponible. Hay un examen de red activo en curso. La aplicación que realiza la llamada puede recibir notificaciones cuando las funcionalidades del dispositivo están disponibles registrando para el método OnScanNetworkComplete de IMbnInterfaceEvents.
E_MBN_INVALID_CACHE
 La caché de banda ancha móvil de la lista de redes visibles no es válida. La aplicación que realiza la llamada debe llamar a ScanNetwork para rellenar la memoria caché.

Comentarios

Este método devuelve la lista de proveedores actualmente visibles. Los dispositivos POINT solo notificarán a su proveedor doméstico si hay alguna red en su lista de itinerancia preferida (PRL) disponible.

Para evitar operaciones frecuentes de análisis de red, el sistema operativo mantiene una lista de las operaciones de examen recientes y la lista de proveedores se devuelve de la lista almacenada en caché.

Una aplicación puede llamar a este método para obtener una lista de proveedores visibles tras la finalización de ScanNetwork.

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

IMbnInterface