Méthode IMbnSms::GetSmsConfiguration (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 la configuration SMS d’un appareil.
Syntaxe
HRESULT GetSmsConfiguration(
[out, retval] IMbnSmsConfiguration **smsConfiguration
);
Paramètres
[out, retval] smsConfiguration
Interface IMbnSmsConfiguration représentant la configuration SMS de 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. |
|
La configuration 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 la configuration SMS est disponible en s’inscrivant à la méthode OnSmsConfigurationChange de l’interface IMbnSmsEvents . |
|
Un code confidentiel est nécessaire pour obtenir ces informations. |
|
Il n’y a pas de carte SIM dans l’appareil. |
|
Il y a une carte SIM incorrecte dans l’appareil. |
|
SMS n’est pas pris en charge par 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 OnSmsConfigurationChange de l’interface IMbnSmsEvents
La configuration sms peut être mise à jour par le réseau ou l’appareil sans aucune demande de modification par n’importe quelle application. Dans ce cas, le service Haut débit mobile notifie toutes les applications inscrites en appelant la méthode OnSmsConfigurationChange 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 |