Metodo IMbnInterface::GetReadyState (mbnapi.h)
Importante
A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.
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.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. readyState contiene valori validi. |
|
Le informazioni non sono disponibili. Il servizio Mobile Broadband sta attualmente eseguendo il probe dello stato pronto. L'applicazione chiamante può ricevere una notifica quando lo stato pronto è disponibile registrando per il metodo OnReadyStateChange di IMbnInterfaceEvents. |
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
| Client minimo supportato | Windows 7 [app desktop | App UWP] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |