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 |
---|---|
|
La commande s'est correctement terminée. |
|
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. |
|
Un code confidentiel est nécessaire pour obtenir ces informations. |
|
Aucune carte SIM n’est insérée dans l’appareil. |
|
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 |