Método IMbnConnection::Connect (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.
Establece una conexión de datos.
Sintaxis
HRESULT Connect(
[in] MBN_CONNECTION_MODE connectionMode,
[in] LPCWSTR strProfile,
[out] ULONG *requestID
);
Parámetros
[in] connectionMode
Valor MBN_CONNECTION_MODE que especifica el modo de la conexión.
[in] strProfile
Contiene el designador de perfiles.
[out] requestID
Puntero a un identificador de solicitud único devuelto por el servicio Mobile Broadband para identificar esta solicitud asincrónica.
Valor devuelto
Este método puede devolver uno de estos valores.
| Código devuelto | Descripción |
|---|---|
|
La operación se realizó correctamente. |
|
El servicio de banda ancha móvil no se está ejecutando en este sistema. |
|
Interfaz no válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema. |
|
Interfaz no válida. Lo más probable es que el dispositivo de banda ancha móvil se haya quitado del sistema. |
|
Se especificó un nombre de perfil no válido o el argumento strProfile no es compatible con el esquema de perfil XML. |
|
Ya hay un contexto activo de banda ancha móvil. No se admiten varios contextos activos. |
Comentarios
El método Connect se usa para activar un contexto de conexión para el dispositivo. Actualmente, el servicio de banda ancha móvil admite como máximo un contexto activo. La activación del contexto también dará lugar a que también se establezca la conexión L2. Del mismo modo, la desactivación de un contexto dará lugar a la desconexión de la conexión de datos físicas a la red móvil.
Si el dispositivo no está en el estado asociado al paquete en el momento de llamar a esta operación, el servicio de banda ancha móvil conectará implícitamente el dispositivo antes de emitir la solicitud de conexión al dispositivo. Si hay algún cambio de estado del servicio de paquetes, se notificará a la aplicación mediante una llamada al método OnPacketServiceStateChange de la interfaz IMbnRegistrationEvents .
Si connectionMode se establece en MBN_CONNECTION_MODE_PROFILE, strProfile representa el nombre del perfil del dispositivo. Si se establece en MBN_CONNECTION_MODE_TMP_PROFILE, strProfile representa la representación XML del perfil. Una aplicación de llamada puede usar IMbnConnectionProfileManager para obtener una lista de perfiles de conexión almacenados en el dispositivo.
Se trata de una operación asincrónica que devolverá inmediatamente. Si este método se devuelve correctamente, el servicio de banda ancha móvil llamará al método OnConnectComplete de IMbnConnectionEvents cuando se complete la operación.
Windows 8 y versiones posteriores de Windows: una aplicación de la Tienda Windows puede usar Connect solo con el MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode y el parámetro strProfile establecido en una representación XML del perfil. Esto implica que la conexión es de naturaleza temporal y no se guarda para su uso futuro por parte del sistema.
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 |