Compartir a través de

Método IMbnRegistration::GetAvailableDataClasses (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 las clases de datos disponibles en la red actual.

Sintaxis

HRESULT GetAvailableDataClasses(
  [out] ULONG *availableDataClasses
);

Parámetros

[out] availableDataClasses

Puntero a una combinación OR bit a bit de MBN_DATA_CLASS valores. Este parámetro solo es significativo si la función devuelve S_OK.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 La operación se realizó correctamente.
E_PENDING
 Las clases de datos no están disponibles. El servicio de banda ancha móvil está sondeando actualmente el dispositivo para obtener la información. Cuando las clases de datos estén disponibles, el servicio de banda ancha móvil llamará al método OnPacketServiceStateChange de IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED
 Se requiere un PIN para obtener las clases de datos.

Comentarios

GetAvailableDataClasses devuelve el conjunto de clases de datos posibles en la red actual. Estos valores se pueden establecer en MBN_DATA_CLASS_NONE si no se conoce el valor.

Las clases de datos disponibles pueden cambiar automáticamente a medida que un dispositivo se mueve de una celda a otra. Siempre que se produzca este cambio, el servicio de banda ancha móvil notificará a las aplicaciones mediante una llamada al método OnPacketServiceStateChange de IMbnRegistrationEvents.

Para el error recuperable E_MBN_PIN_REQUIRED, el servicio de banda ancha móvil volverá a intentar capturar esta información del dispositivo cuando se supere la condición de error (cuando se introduce un PIN). Después, el servicio de banda ancha móvil llamará al método OnPacketServiceStateChange de IMbnRegistrationEvents.

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

IMbnRegistration