Método IMbnConnection::Connect (mbnapi.h)
Importante
A partir do Windows 10, versão 1803, as APIs do Win32 descritas nesta seção são substituídas pelas APIs Windows Runtime no namespace Windows.Networking.Connectivity.
Estabelece uma conexão de dados.
Sintaxe
HRESULT Connect(
[in] MBN_CONNECTION_MODE connectionMode,
[in] LPCWSTR strProfile,
[out] ULONG *requestID
);
Parâmetros
[in] connectionMode
Um valor MBN_CONNECTION_MODE que especifica o modo da conexão.
[in] strProfile
Contém o designador de perfil.
[out] requestID
Um ponteiro para uma ID de solicitação exclusiva retornada pelo serviço de Banda Larga Móvel para identificar essa solicitação assíncrona.
Valor retornado
Esse método pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
A operação foi bem-sucedida. |
|
O serviço de Banda Larga Móvel não está em execução neste sistema. |
|
Interface inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
Interface inválida. Provavelmente, o dispositivo de Banda Larga Móvel foi removido do sistema. |
|
Um nome de perfil inválido foi especificado ou o argumento strProfile não está em conformidade com o esquema de perfil XML |
|
Já existe um contexto de Banda Larga Móvel ativo. Não há suporte para vários contextos ativos. |
Comentários
O método Connect é usado para ativar um contexto de conexão para o dispositivo. Atualmente, o serviço de Banda Larga Móvel dá suporte a no máximo um contexto ativo. A ativação do contexto também fará com que a conexão L2 também seja estabelecida. Da mesma forma, a desativação de um contexto resultará na desconexão da conexão de dados físicos com a rede móvel.
Se o dispositivo não estiver no estado anexado a pacotes no momento da chamada a essa operação, o serviço de Banda Larga Móvel anexará implicitamente o dispositivo antes de emitir a solicitação de conexão ao dispositivo. Se houver alguma alteração de estado do serviço de pacote, o aplicativo será notificado por uma chamada para o método OnPacketServiceStateChange da interface IMbnRegistrationEvents .
Se connectionMode estiver definido como MBN_CONNECTION_MODE_PROFILE, strProfile representará o nome do perfil do dispositivo. Se definido como MBN_CONNECTION_MODE_TMP_PROFILE, strProfile representará a representação XML do perfil. Um aplicativo de chamada pode usar IMbnConnectionProfileManager para obter uma lista de perfis de conexão armazenados no dispositivo.
Essa é uma operação assíncrona que retornará imediatamente. Se esse método retornar com êxito, o serviço de Banda Larga Móvel chamará o método OnConnectComplete de IMbnConnectionEvents quando a operação for concluída.
Windows 8 e versões posteriores do Windows: um aplicativo da Windows Store pode usar Conectar somente com o MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode e o parâmetro strProfile definido como uma representação XML do perfil. Isso implica que a conexão é de natureza temporária e não é salva para uso futuro pelo sistema.
Requisitos
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | mbnapi.h |