IMbnInterface::GetReadyState, méthode (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 l’état prêt.
Syntaxe
HRESULT GetReadyState(
[out, retval] MBN_READY_STATE *readyState
);
Paramètres
[out, retval] readyState
Pointeur vers une structure MBN_READY_STATE . Si cette méthode retourne une valeur autre que S_OK, ce paramètre a la valeur NULL.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée. readyState contient des valeurs valides. |
|
Les informations ne sont pas disponibles. Le service haut débit mobile recherche actuellement l’état prêt. L’application appelante peut être avertie lorsque l’état prêt est disponible en s’inscrivant à la méthode OnReadyStateChange de IMbnInterfaceEvents. |
Notes
L’état ready spécifie si l’interface est correctement initialisée et prête à effectuer des opérations de connexion. Pour les appareils basés sur SIM, un appareil est prêt lorsque la carte SIM a été initialisée avec succès par l’appareil. L’appareil ne peut être utilisé pour la connexion que lorsque l’état prêt est MBN_READY_STATE_INITIALIZED. Pour plus d’informations sur les autres états des appareils, consultez MBN_READY_STATE.
L’état prêt d’une interface peut changer à la suite d’une opération utilisateur. Par exemple, lorsqu’un utilisateur insère une carte SIM dans un appareil, l’état prêt passe de MBN_READY_STATE_SIM_NOT_INSERTED à un autre état prêt. L’état prêt peut également changer en raison d’autres opérations effectuées par l’application. Par exemple, lorsqu’un code confidentiel a été entré, l’état prêt peut passer de MBN_READY_STATE_DEVICE_LOCKED à un autre état prêt. Une application peut s’inscrire aux notifications d’événements chaque fois qu’il y a un changement dans l’état prêt de l’interface. Le membre OnReadyStateChange de IMbnInterfaceEvents est appelé pour informer une application de toute modification de l’état prêt.
Le sous-système SMS de l’appareil peut ne pas être prêt lorsqu’il signale MBN_READY_STATE_INITIALIZED. Une application appelante doit attendre un appel au membre OnSmsConfigurationChange de IMbnSmsEvents, indiquant que le sous-système SMS est prêt.
Configuration requise
| Client minimal pris en charge | Windows 7 [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | mbnapi.h |