Metodo IMbnSms::GetSmsConfiguration (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 la configurazione SMS di un dispositivo.
Sintassi
HRESULT GetSmsConfiguration(
[out, retval] IMbnSmsConfiguration **smsConfiguration
);
Parametri
[out, retval] smsConfiguration
Interfaccia IMbnSmsConfiguration che rappresenta la configurazione SMS del dispositivo.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
La configurazione SMS non è disponibile. Il servizio Mobile Broadband esegue il probe del dispositivo per le informazioni. L'applicazione chiamante può ricevere una notifica quando la configurazione SMS è disponibile registrando per il metodo OnSmsConfigurationChange dell'interfaccia IMbnSmsEvents . |
|
Per ottenere queste informazioni è necessario un PIN. |
|
Non è presente alcuna SIM nel dispositivo. |
|
Nel dispositivo è presente una SIM errata. |
|
SMS non è supportato dal dispositivo. |
Commenti
Per gli errori ripristinabili, ad esempio E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, il servizio Mobile Broadband eseguirà di nuovo una query sul dispositivo per ottenere queste informazioni quando la condizione di errore è finita. Ad esempio, se il dispositivo richiede l'immissione di un PIN per recuperare queste informazioni, restituirà E_MBN_PIN_REQUIRED. Quando un'applicazione immette il PIN per sbloccare il dispositivo, il servizio Mobile Broadband tenterà nuovamente di ottenere queste informazioni dal dispositivo. Il servizio Mobile Broadband chiamerà il metodo OnSmsConfigurationChange dell'interfaccia IMbnSmsEvents
La configurazione SMS può essere aggiornata dalla rete o dal dispositivo senza alcuna richiesta di modifica da parte di qualsiasi applicazione. In tal caso, il servizio Mobile Broadband invierà una notifica a tutte le applicazioni registrate chiamando il metodo OnSmsConfigurationChange dell'interfaccia IMbnSmsEvents .
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |