Compartilhar via

Método IMbnInterface::GetReadyState (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 pronto.

Sintaxe

HRESULT GetReadyState(
  [out, retval] MBN_READY_STATE *readyState
);

Parâmetros

[out, retval] readyState

Um ponteiro para uma estrutura MBN_READY_STATE . Se esse método retornar qualquer valor diferente de S_OK, esse parâmetro será NULL.

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. readyState contém valores válidos.
E_PENDING
 As informações não estão disponíveis. O serviço de Banda Larga Móvel está atualmente investigando o estado pronto. O aplicativo de chamada pode ser notificado quando o estado pronto está disponível registrando-se para o método OnReadyStateChange de IMbnInterfaceEvents.

Comentários

O estado pronto especifica se a interface foi inicializada com êxito e está pronta para executar operações de conexão. Para dispositivos baseados em SIM, um dispositivo estará pronto quando o SIM tiver sido inicializado com êxito pelo dispositivo. O dispositivo só pode ser usado para conexão quando o estado pronto é MBN_READY_STATE_INITIALIZED. Para obter mais informações sobre outros estados do dispositivo, consulte MBN_READY_STATE.

O estado pronto de uma interface pode ser alterado como resultado de uma operação do usuário. Por exemplo, quando um usuário insere um SIM em um dispositivo, o estado pronto muda de MBN_READY_STATE_SIM_NOT_INSERTED para outro estado pronto. O estado pronto também pode ser alterado devido a outras operações executadas pelo aplicativo. Por exemplo, quando um PIN é inserido, o estado pronto pode mudar de MBN_READY_STATE_DEVICE_LOCKED para outro estado pronto. Um aplicativo pode se registrar para notificações de eventos sempre que houver uma alteração no estado pronto da interface. O membro OnReadyStateChange de IMbnInterfaceEvents é chamado para notificar um aplicativo sobre qualquer alteração no estado pronto.

O subsistema SMS do dispositivo pode não estar pronto quando relatar MBN_READY_STATE_INITIALIZED. Um aplicativo de chamada deve aguardar uma chamada para o membro OnSmsConfigurationChange de IMbnSmsEvents, indicando que o subsistema SMS está pronto.

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

IMbnInterface