Méthode IMbnSmsEvents::OnSmsReadComplete (mbnapi.h)

Article
08/24/2023

Important

À compter de Windows 10, version 1803, les API Win32 décrites dans cette section sont remplacées par les API Windows Runtime dans l’espace de noms Windows.Networking.Connectivity.

Méthode de notification indiquant l’achèvement d’une opération de lecture de message.

Syntaxe

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

Paramètres

[in] sms

Interface IMbnSms représentant la banque de messages qui a terminé l’opération.

[in] smsFormat

Valeur MBN_SMS_FORMAT qui définit le format du message SMS.

[in] readMsgs

Tableau de messages lus à partir de l’appareil.

[in] moreMsgs

Valeur booléenne qui indique s’il y a encore plus de messages en cours de traitement. Si la valeur est TRUE, OnSmsReadComplete est appelé à plusieurs reprises jusqu’à ce qu’il n’y ait plus de messages et que moreMsgs ait la valeur FALSE.

[in] requestID

ID de demande attribué par le service Haut débit mobile pour identifier l’opération de lecture du message.

[in] status

Un code status qui indique le résultat de l’opération.

Une application appelante peut s’attendre à l’une des valeurs suivantes.

Valeur	Signification
S_OK	L'opération a réussi.
E_MBN_SIM_NOT_INSERTED	Il n’y a pas de carte SIM dans l’appareil.
E_MBN_BAD_SIM	Il y a une carte SIM incorrecte dans l’appareil.
E_MBN_PIN_REQUIRED	Un code confidentiel est nécessaire pour que l’opération se termine.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	L’opération SMS ou le format SMS particulier n’est pas pris en charge par l’appareil.
E_MBN_SMS_MEMORY_FAILURE	Échec de la mémoire SMS.
E_MBN_SMS_INVALID_MEMORY_INDEX	Il n’existe aucun index de mémoire avec la valeur demandée.
E_MBN_SMS_FILTER_NOT_SUPPORTED	L’appareil ne prend pas en charge le filtre demandé.

Valeur retournée

Cette méthode doit retourner S_OK.

Notes

Pour les appareils GSM, l’application appelante doit appeler QueryInterface sur chaque élément dans readMsgs pour une interface IMbnSmsReadMsgPdu .

Pour les appareils CDMA, si smsFormat est MBN_SMS_FORMAT_TEXT, l’application doit appeler QueryInterface pour une interface IMbnSmsReadMsgTextCdma ; sinon, si smsFormat est MBN_SMS_FORMAT_PDU, l’application doit appeler QueryInterface pour une interface IMbnSmsReadMsgPdu .

Si une demande de lecture entraîne la lecture d’une grande quantité de messages, OnSmsReadComplete peut être appelé à plusieurs reprises jusqu’à ce que moreMsgs indique qu’il n’y a plus de messages à lire.

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	mbnapi.h

Voir aussi

IMbnSmsEvents

Partager via