Méthode IMbnConnection::GetConnectionState (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 de connexion actuel de l’appareil.
Syntaxe
HRESULT GetConnectionState(
[out, retval] MBN_ACTIVATION_STATE *ConnectionState,
[out, retval] BSTR *ProfileName
);
Paramètres
[out, retval] ConnectionState
Pointeur vers une structure MBN_ACTIVATION_STATE qui contient l’état de la connexion.
[out, retval] ProfileName
Pointeur vers une chaîne qui contient le nom du profil de connexion. Ce paramètre n’est valide que lorsque ConnectionState est MBN_ACTIVATION_STATE_ACTIVATED. Lorsque cette chaîne n’est pas NULL, l’application appelante doit libérer cette chaîne en appelant SysFreeString.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La commande s'est correctement terminée.
Note Cette méthode peut retourner S_OK lorsque ProfileName a la valeur NULL. Assurez-vous que votre client est capable de gérer un nom de profilNULL même si l’appel réussit.
|
|
État d’activation non disponible. Le service haut débit mobile sonde l’appareil pour obtenir des informations. L’application appelante peut être avertie lorsque l’état d’activation est disponible en s’inscrivant à la méthode OnConnectStateChanged’IMbnConnectionEvents. |
|
Un code confidentiel est requis pour obtenir l’état de l’appel. |
|
Une carte SIM n’est pas insérée dans l’appareil. |
|
Une carte SIM incorrecte est insérée dans l’appareil. |
Notes
Cette méthode peut retourner S_OK lorsque ProfileName a la valeur NULL. Assurez-vous que votre client est capable de gérer un nom de profilNULL même si l’appel réussit.
Spécifications
| 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 |