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

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