Méthode IMbnSms::SmsRead (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.

Lit un ensemble de messages SMS à partir d’un appareil.

Syntaxe

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

Paramètres

[in] smsFilter

Pointeur vers une structure MBN_SMS_FILTER qui définit l’ensemble de messages à lire.

[in] smsFormat

Valeur MBN_SMS_FORMAT qui spécifie le format dans lequel un message SMS doit être lu.

Pour les appareils GSM, il doit toujours être MBN_SMS_FORMAT_PDU.

Pour les appareils CDMA, si cela est spécifié comme MBN_SMS_FORMAT_PDU, l’appareil lira un message CDMA en mode binaire. S’il est spécifié comme MBN_SMS_FORMAT_TEXT, l’appareil lit un message CDMA en mode texte. Si l’appareil ne prend pas en charge le format spécifié, il peut retourner un code d’erreur.

[out] requestID

Pointeur vers un ID de demande émis par le service haut débit mobile pour identifier cette demande.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Le service haut débit mobile n’est pas en cours d’exécution sur ce système.
E_HANDLE	L’interface n’est pas valide, probablement parce que l’appareil a été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	L’interface n’est pas valide. Très probablement, l’appareil haut débit mobile a été supprimé du système.
E_INVALIDARG	smsFormat ou smsFilter n’est pas valide.

Notes

À l’aide de smsFilter, une application peut spécifier des filtres de base tels que de nouveaux messages, des brouillons de messages ou un message spécifique à l’aide d’un index. Un filtre complexe peut être utilisé en intégrant une combinaison de filtres de base. Toutes les interfaces prennent en charge les filtres basés sur un index et les nouveaux filtres de type de message. La prise en charge d’autres filtres est facultative pour certaines interfaces. Si le filtre spécifié n’est pas pris en charge, la fonction de rappel de fin d’opération retourne une status de E_MBN_STATUS_FILTER_NOT_SUPPORTED.

Il s’agit d’une opération asynchrone qui retourne immédiatement. Si la méthode retourne sans erreur, le service haut débit mobile appelle la méthode OnSmsReadComplete de l’interface IMbnSmsEvents .

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

IMbnSms

Partager via