Metodo IMbnSmsEvents::OnSmsReadComplete (mbnapi.h)

Articolo
08/24/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.

Metodo di notifica che indica il completamento di un'operazione di lettura del messaggio.

Sintassi

HRESULT OnSmsReadComplete(
  [in] IMbnSms        *sms,
  [in] MBN_SMS_FORMAT smsFormat,
  [in] SAFEARRAY      *readMsgs,
  [in] VARIANT_BOOL   moreMsgs,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Parametri

[in] sms

Interfaccia IMbnSms che rappresenta l'archivio messaggi che ha completato l'operazione.

[in] smsFormat

Valore MBN_SMS_FORMAT che definisce il formato del messaggio SMS.

[in] readMsgs

Matrice di messaggi letti dal dispositivo.

[in] moreMsgs

Valore booleano che indica se sono ancora in corso l'elaborazione di altri messaggi. Se è TRUE, OnSmsReadComplete verrà chiamato ripetutamente finché non sono presenti altri messaggi e moreMsgs è FALSE.

[in] requestID

ID richiesta assegnato dal servizio Mobile Broadband per identificare l'operazione di lettura del messaggio.

[in] status

Codice di stato che indica il risultato dell'operazione.

Un'applicazione chiamante può prevedere uno dei valori seguenti.

Valore	Significato
S_OK	L'operazione è stata completata.
E_MBN_SIM_NOT_INSERTED	Non è presente alcuna SIM nel dispositivo.
E_MBN_BAD_SIM	Nel dispositivo è presente una SIM errata.
E_MBN_PIN_REQUIRED	Per completare l'operazione è necessario un PIN.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L'operazione SMS o il formato SMS specifico non è supportato dal dispositivo.
E_MBN_SMS_MEMORY_FAILURE	Errore di memoria SMS.
E_MBN_SMS_INVALID_MEMORY_INDEX	Non esiste alcun indice di memoria con il valore richiesto.
E_MBN_SMS_FILTER_NOT_SUPPORTED	Il dispositivo non supporta il filtro richiesto.

Valore restituito

Questo metodo deve restituire S_OK.

Commenti

Per i dispositivi GSM, l'applicazione chiamante deve chiamare QueryInterface su ogni elemento in readMsgs per un'interfaccia IMbnSmsReadMsgPdu .

Per i dispositivi CDMA, se smsFormat è MBN_SMS_FORMAT_TEXT, l'applicazione deve chiamare QueryInterface per un'interfaccia IMbnSmsReadMsgTextCdma ; in caso contrario, se smsFormat è MBN_SMS_FORMAT_PDU, l'applicazione deve chiamare QueryInterface per un'interfaccia IMbnSmsReadMsgPdu .

Se una richiesta di lettura comporta una grande quantità di messaggi letti, è possibile che OnSmsReadComplete venga chiamato ripetutamente finché moreMsgs non indica che non sono più messaggi da leggere.

Requisiti


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

Vedi anche

IMbnSmsEvents

Condividi tramite