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

Obtiene la lista de proveedores visibles en el área actual de un dispositivo multiuso menos los proveedores preferidos y registrados.

Sintaxis

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

Parámetros

[out] age

Puntero al tiempo, en segundos, desde la última actualización de la lista de proveedores visible para el dispositivo.

[out, retval] visibleProviders

Puntero a una matriz de estructuras de MBN_PROVIDER2 que contiene la lista de proveedores para la interfaz. Si este método devuelve cualquier valor distinto de S_OK, visibleProviders es NULL. Cuando GetVisibleProviders devuelve S_OK, la aplicación que realiza la 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 IMbnMultiCarrierEvents
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é.
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 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 examen de red, Windows 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.

Esta lista contiene todas las redes actualmente visibles disponibles en la ubicación del usuario, excepto las notificadas por el proveedor registrado actual y la lista de proveedores preferidos. Esta lista contiene entradas de red a las que los usuarios no se han suscrito. Esta lista proporciona al usuario un conjunto adicional de opciones de red para las que puede registrarse.

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