Método IMbnConnection::Connect (mbnapi.h)

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.

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

Confira também

IMbnConnection