Metodo IMbnSms::SmsRead (mbnapi.h)

Articolo
03/09/2023

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.

Legge un set di messaggi SMS da un dispositivo.

Sintassi

HRESULT SmsRead(
  [in]  MBN_SMS_FILTER *smsFilter,
  [in]  MBN_SMS_FORMAT smsFormat,
  [out] ULONG          *requestID
);

Parametri

[in] smsFilter

Puntatore a una struttura MBN_SMS_FILTER che definisce il set di messaggi da leggere.

[in] smsFormat

Valore MBN_SMS_FORMAT che specifica il formato in cui deve essere letto un messaggio SMS.

Per i dispositivi GSM, deve sempre essere MBN_SMS_FORMAT_PDU.

Per i dispositivi CDMA, se viene specificato come MBN_SMS_FORMAT_PDU, il dispositivo leggerà un messaggio CDMA in modalità binaria. Se viene specificato come MBN_SMS_FORMAT_TEXT, il dispositivo leggerà un messaggio CDMA in modalità testo. Se il dispositivo non supporta il formato specificato, può restituire un codice di errore.

[out] requestID

Puntatore a un ID richiesta emesso dal servizio Mobile Broadband per identificare questa richiesta.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Il servizio Mobile Broadband non è in esecuzione in questo sistema.
E_HANDLE	L'interfaccia non è valida, probabilmente perché il dispositivo è stato rimosso dal sistema.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L'interfaccia non è valida. Molto probabilmente il dispositivo Mobile Broadband è stato rimosso dal sistema.
E_INVALIDARG	smsFormat o smsFilter non è valido.

Commenti

Tramite smsFilter, un'applicazione può specificare filtri di base, ad esempio nuovi messaggi, messaggi bozza o un messaggio specifico usando un indice. Un filtro complesso può essere usato integrando una combinazione di filtri di base. Tutte le interfacce supportano i filtri basati sull'indice e i nuovi filtri dei tipi di messaggio. Il supporto per altri filtri è facoltativo per alcune interfacce. Se il filtro specificato non è supportato, la funzione di callback di completamento dell'operazione restituirà lo stato E_MBN_STATUS_FILTER_NOT_SUPPORTED.

Si tratta di un'operazione asincrona che restituirà immediatamente. Se il metodo restituisce senza errori, il servizio Mobile Broadband chiamerà il metodo OnSmsReadComplete dell'interfaccia IMbnSmsEvents .

Requisiti


Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	mbnapi.h

Vedi anche

IMbnSms

Condividi tramite