Metodo IMbnInterface::GetReadyState (mbnapi.h)

Ottiene lo stato pronto.

Sintassi

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

Parametri

[out, retval] readyState

Puntatore a una struttura MBN_READY_STATE . Se questo metodo restituisce un valore diverso da S_OK, questo parametro è NULL.

Valore restituito

Questo metodo può restituire uno di questi valori.

Commenti

Lo stato ready specifica se l'interfaccia è stata inizializzata correttamente ed è pronta per eseguire le operazioni di connessione. Per i dispositivi basati su SIM, un dispositivo è pronto quando la SIM è stata inizializzata correttamente dal dispositivo. Il dispositivo può essere usato per la connessione solo quando lo stato pronto è MBN_READY_STATE_INITIALIZED. Per altre informazioni sugli altri stati del dispositivo, vedere MBN_READY_STATE.

Lo stato pronto di un'interfaccia può cambiare in seguito a un'operazione dell'utente. Ad esempio, quando un utente inserisce una SIM in un dispositivo, lo stato pronto passa da MBN_READY_STATE_SIM_NOT_INSERTED a un altro stato pronto. Lo stato pronto può anche cambiare a causa di altre operazioni eseguite dall'applicazione. Ad esempio, quando è stato immesso un PIN, lo stato pronto può passare da MBN_READY_STATE_DEVICE_LOCKED a un altro stato pronto. Un'applicazione può registrarsi per le notifiche degli eventi ogni volta che si verifica una modifica nello stato pronto dell'interfaccia. Il membro OnReadyStateChange di IMbnInterfaceEvents viene chiamato per notificare a un'applicazione qualsiasi modifica nello stato pronto.

Il sottosistema SMS del dispositivo potrebbe non essere pronto quando segnala MBN_READY_STATE_INITIALIZED. Un'applicazione chiamante deve attendere una chiamata al membro OnSmsConfigurationChange di IMbnSmsEvents, che indica che il sottosistema SMS è pronto.

Requisiti

Vedi anche

IMbnInterface