Compartir a través de

Método IMbnConnection::GetConnectionState (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 el estado de conexión actual del dispositivo.

Sintaxis

HRESULT GetConnectionState(
  [out, retval] MBN_ACTIVATION_STATE *ConnectionState,
  [out, retval] BSTR                 *ProfileName
);

Parámetros

[out, retval] ConnectionState

Puntero a una estructura de MBN_ACTIVATION_STATE que contiene el estado de la conexión.

[out, retval] ProfileName

Puntero a una cadena que contiene el nombre del perfil de conexión. Este parámetro solo es válido cuando ConnectionState está MBN_ACTIVATION_STATE_ACTIVATED. Cuando esta cadena no es NULL, la aplicación que realiza la llamada debe liberar esta cadena llamando a SysFreeString.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK
 El método se completó correctamente.
Nota Este método puede devolver S_OK cuando ProfileName es NULL. Asegúrese de que el cliente es capaz de controlar un Valor ProfileNameNULL incluso si la llamada se realiza correctamente.
 
E_PENDING
 El estado de activación no está disponible. El servicio de banda ancha móvil está sondeando el dispositivo para obtener la información. La aplicación que realiza la llamada se puede notificar cuando el estado de activación está disponible registrando para el método OnConnectStateChange de IMbnConnectionEvents.
E_MBN_PIN_REQUIRED
 Se requiere un PIN para obtener el estado de la llamada.
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

Este método puede devolver S_OK cuando ProfileName es NULL. Asegúrese de que el cliente es capaz de controlar un Valor ProfileNameNULL incluso si la llamada se realiza correctamente.

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

IMbnConnection