Compartilhar via

Método IMbnConnectionEvents::OnConnectComplete (mbnapi.h)

  • Artigo

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.

Método de notificação que sinaliza a conclusão de uma operação de conexão.

Sintaxe

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

Parâmetros

[in] newConnection

Uma interface IMbnConnection que representa o dispositivo no qual a operação de conexão foi concluída.

[in] requestID

A ID de solicitação atribuída pelo serviço de Banda Larga Móvel para identificar a operação de conexão.

[in] status

O status de conclusão.

Um aplicativo de chamada pode esperar um dos valores a seguir.

Valor Significado
S_OK
 A operação foi bem-sucedida.
E_MBN_SIM_NOT_INSERTED
 Não há nenhum SIM no dispositivo.
E_MBN_PIN_REQUIRED
 Um PIN é necessário para que a operação seja concluída.
E_MBN_SERVICE_NOT_ACTIVATED
 A assinatura do serviço de rede expirou.
E_MBN_PROVIDER_NOT_VISIBLE
 O provedor não está visível. Isso se aplica somente ao modo de registro manual.
E_MBN_INVALID_ACCESS_STRING
 A cadeia de caracteres de acesso à conexão não está correta.
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)
 O nome ou senha que usa no perfil de conexão não está correto.
E_MBN_VOICE_CALL_IN_PROGRESS
 Uma chamada de voz ativa está em andamento.
E_MBN_MAX_ACTIVATED_CONTEXTS
 Já existe um contexto de Banda Larga Móvel ativo. Atualmente, o serviço de Banda Larga Móvel não dá suporte a vários contextos ativos.
E_MBN_RADIO_POWER_OFF
 O rádio do dispositivo está desativado.
E_MBN_PACKET_SVC_DETACHED
 Nenhum serviço de pacote anexado ativo está disponível.
E_MBN_ACTIVE_CONNECTION
 O dispositivo já está conectado à rede.

Valor retornado

Esse método deve retornar S_OK.

Comentários

Depois que um contexto de ativação é estabelecido, um aplicativo pode usar IMbnConnection para obter o estado de conexão atual.

Quando a operação de conexão resulta em um erro, um aplicativo pode chamar o método GetActivationNetworkError da interface IMbnConnection para obter informações de erro de rede.

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

Confira também

IMbnConnectionEvents