Método IMbnInterface::GetReadyState (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.
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 |
|---|---|
|
O método foi concluído com sucesso. readyState contém valores válidos. |
|
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 |