Metodo IMbnSms::GetSmsStatus (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 SMS per un dispositivo.
Sintassi
HRESULT GetSmsStatus(
[out] MBN_SMS_STATUS_INFO *smsStatusInfo
);
Parametri
[out] smsStatusInfo
Puntatore a una struttura di MBN_SMS_STATUS_INFO contenente le informazioni sullo stato per il dispositivo.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
Lo stato SMS non è disponibile. Il servizio Mobile Broadband sta verificando il dispositivo per le informazioni. L'applicazione chiamante può ricevere una notifica quando lo stato SMS è disponibile registrando per il metodo OnSmsStatusChange dell'interfaccia IMbnSmsEvents . |
|
Per ottenere queste informazioni è necessario un PIN. |
|
Una SIM non viene inserita nel dispositivo. |
|
Una SIM non valida viene inserita nel dispositivo. |
Commenti
Per gli errori recuperabili, ad esempio E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED e E_MBN_BAD_SIM, il servizio Mobile Broadband eseguirà nuovamente una query sul dispositivo per queste informazioni quando la condizione di errore è finita. Ad esempio, se il dispositivo ha richiesto 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 OnSmsStatusChange dell'interfaccia IMbnSmsEvents
Lo stato dell'archivio messaggi SMS può cambiare a causa del nuovo messaggio ricevuto dal sistema. In qualsiasi modifica dello stato dell'archivio messaggi, il servizio Mobile Broadband chiamerà il metodo OnSmsStatusChange dell'interfaccia IMbnSmsEvent .
Le operazioni rilasciate dall'applicazione, ad esempio la lettura o l'eliminazione di messaggi, possono reimpostare il flag nella struttura MBN_SMS_STATUS_INFO . Una modifica nell'archivio SMS causata da questa reimpostazione non comporta la chiamata di alcun metodo di notifica.
Requisiti
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Nessuno supportato |
| Piattaforma di destinazione | Windows |
| Intestazione | mbnapi.h |