Partager via


Méthode IMbnSms::GetSmsStatus (mbnapi.h)

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.

Obtient le status SMS d’un appareil.

Syntaxe

HRESULT GetSmsStatus(
  [out] MBN_SMS_STATUS_INFO *smsStatusInfo
);

Paramètres

[out] smsStatusInfo

Pointeur vers une structure de MBN_SMS_STATUS_INFO contenant les informations status pour l’appareil.

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.
E_PENDING
Le status SMS n’est pas disponible. Le service Haut débit mobile sonde l’appareil à des fins d’information. L’application appelante peut être avertie quand le status SMS est disponible en s’inscrivant à la méthode OnSmsStatusChange de l’interface IMbnSmsEvents.
E_MBN_PIN_REQUIRED
Un code confidentiel est nécessaire pour obtenir ces informations.
E_MBN_SIM_NOT_INSERTED
Aucune carte SIM n’est insérée dans l’appareil.
E_MBN_BAD_SIM
Une carte SIM incorrecte est insérée dans l’appareil.

Notes

Pour les erreurs récupérables telles que E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED et E_MBN_BAD_SIM, le service haut débit mobile interroge à nouveau l’appareil pour obtenir ces informations lorsque la condition d’erreur est terminée. Par exemple, si l’appareil a requis la saisie d’un code confidentiel pour récupérer ces informations, il retourne E_MBN_PIN_REQUIRED. Lorsqu’une application entre dans le code confidentiel pour déverrouiller l’appareil, le service haut débit mobile tente à nouveau d’obtenir ces informations à partir de l’appareil. Le service Haut débit mobile appelle la méthode OnSmsStatusChange de l’interface IMbnSmsEvents

Le magasin de messages SMS status peut changer en raison d’un nouveau message reçu par le système. En cas de modification dans le magasin de messages status, le service haut débit mobile appelle la méthode OnSmsStatusChange de l’interface IMbnSmsEvent.

Les opérations émises par l’application, telles que la lecture ou la suppression de messages, peuvent réinitialiser l’indicateur dans MBN_SMS_STATUS_INFO structure. Un changement dans le magasin DE SMS provoqué par cette réinitialisation n’entraîne pas l’appel d’une méthode de notification.

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