Compartilhar via

Método IMbnConnection::GetConnectionState (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.

Obtém o estado de conexão atual do dispositivo.

Sintaxe

HRESULT GetConnectionState(
  [out, retval] MBN_ACTIVATION_STATE *ConnectionState,
  [out, retval] BSTR                 *ProfileName
);

Parâmetros

[out, retval] ConnectionState

Um ponteiro para uma estrutura MBN_ACTIVATION_STATE que contém o estado da conexão.

[out, retval] ProfileName

Um ponteiro para uma cadeia de caracteres que contém o nome do perfil de conexão. Esse parâmetro é válido somente quando ConnectionState é MBN_ACTIVATION_STATE_ACTIVATED. Quando essa cadeia de caracteres não for NULL, o aplicativo de chamada deverá liberar essa cadeia de caracteres chamando SysFreeString.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi concluído com sucesso.
Nota Esse método pode retornar S_OK quando ProfileName for NULL. Verifique se o cliente é capaz de lidar com um ProfileNameNULL mesmo que a chamada seja bem-sucedida.
 
E_PENDING
 O estado de ativação não disponível. O serviço de Banda Larga Móvel está sondando o dispositivo para obter as informações. O aplicativo de chamada pode ser notificado quando o estado de ativação está disponível registrando-se para o método OnConnectStateChange de IMbnConnectionEvents.
E_MBN_PIN_REQUIRED
 Um PIN é necessário para obter o estado da chamada.
E_MBN_SIM_NOT_INSERTED
 Um SIM não é inserido no dispositivo.
E_MBN_BAD_SIM
 Um SIM inválido é inserido no dispositivo.

Comentários

Esse método pode retornar S_OK quando ProfileName for NULL. Verifique se o cliente é capaz de lidar com um ProfileNameNULL mesmo que a chamada seja bem-sucedida.

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

IMbnConnection