Método IMbnConnectionEvents::OnConnectComplete (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.

Método de notificación que señala la finalización de una operación de conexión.

Sintaxis

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parámetros

[in] newConnection

Interfaz IMbnConnection que representa el dispositivo en el que se ha completado la operación de conexión.

[in] requestID

Identificador de solicitud asignado por el servicio de banda ancha móvil para identificar la operación de conexión.

[in] status

Estado de finalización.

Una aplicación que llama puede esperar uno de los siguientes valores.

Valor	Significado
S_OK	La operación se realizó correctamente.
E_MBN_SIM_NOT_INSERTED	No hay ninguna SIM en el dispositivo.
E_MBN_PIN_REQUIRED	Se requiere un PIN para que se complete la operación.
E_MBN_SERVICE_NOT_ACTIVATED	La suscripción del servicio de red ha expirado.
E_MBN_PROVIDER_NOT_VISIBLE	El proveedor no está visible. Esto solo se aplica al modo de registro manual.
E_MBN_INVALID_ACCESS_STRING	La cadena de acceso de conexión no es correcta.
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)	El nombre o la contraseña que usa en el perfil de conexión no es correcto.
E_MBN_VOICE_CALL_IN_PROGRESS	Hay una llamada de voz activa en curso.
E_MBN_MAX_ACTIVATED_CONTEXTS	Ya hay un contexto de banda ancha móvil activo. El servicio de banda ancha móvil no admite actualmente varios contextos activos.
E_MBN_RADIO_POWER_OFF	La radio del dispositivo está apagada.
E_MBN_PACKET_SVC_DETACHED	No hay ningún servicio de paquetes conectado activo disponible.
E_MBN_ACTIVE_CONNECTION	El dispositivo ya está conectado a la red.

Valor devuelto

Este método debe devolver S_OK.

Comentarios

Una vez establecido un contexto de activación, una aplicación puede usar IMbnConnection para obtener el estado de conexión actual.

Cuando la operación de conexión produce un error, una aplicación puede llamar al método GetActivationNetworkError de la interfaz IMbnConnection para obtener información de error de red.

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

IMbnConnectionEvents