Método IMbnRegistration::GetCurrentDataClass (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 clase de datos actual en la red actual.

Sintaxis

HRESULT GetCurrentDataClass(
  [out] ULONG *currentDataClass
);

Parámetros

[out] currentDataClass

Puntero a un valor de MBN_DATA_CLASS . 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. Actualmente, el servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. Cuando las clases de datos estén disponibles, el servicio Mobile Broadband llamará al método OnPacketServiceStateChange de IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED	Se requiere un PIN para obtener las clases de datos.
E_MBN_SIM_NOT_INSERTED	No se inserta una SIM en el dispositivo.
E_MBN_BAD_SIM	Se inserta una SIM incorrecta en el dispositivo.

Comentarios

El método GetCurrentDataClass devuelve la clase de datos de la red actual. Este valor se puede establecer en MBN_DATA_CLASS_NONE si no se conoce el valor.

La clase de datos actual puede cambiar automáticamente a medida que un dispositivo se mueve de una red de telefonía móvil a otra. Cada vez que se produzca este cambio, el servicio de banda ancha móvil notificará a las aplicaciones llamando 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 escribe 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