Méthode IMbnRegistration ::GetCurrentDataClass (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 classe de données actuelle dans le réseau actuel.
Syntaxe
HRESULT GetCurrentDataClass(
[out] ULONG *currentDataClass
);
Paramètres
[out] currentDataClass
Pointeur vers une valeur MBN_DATA_CLASS . Ce paramètre n’a de sens que si la fonction retourne S_OK.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
L'opération a réussi. |
|
Les classes de données ne sont pas disponibles. le service Haut débit mobile est en train de sonder l’appareil pour obtenir des informations. Lorsque les classes de données sont disponibles, le service haut débit mobile appelle la méthode OnPacketServiceStateChange de IMbnRegistrationEvents. |
|
Un code confidentiel est nécessaire pour obtenir les classes de données. |
|
Aucune carte SIM n’est insérée dans l’appareil. |
|
Une carte SIM incorrecte est insérée dans l’appareil. |
Remarques
La méthode GetCurrentDataClass retourne la classe de données dans le réseau actuel. Cette valeur peut être définie sur MBN_DATA_CLASS_NONE si la valeur n’est pas connue.
La classe de données actuelle peut changer automatiquement à mesure qu’un appareil passe d’un réseau cellulaire à un autre. Chaque fois qu’une telle modification se produit, le service haut débit mobile notifie les applications en appelant la méthode OnPacketServiceStateChange de IMbnRegistrationEvents.
Pour l’erreur récupérable E_MBN_PIN_REQUIRED, le service haut débit mobile tente à nouveau d’extraire ces informations de l’appareil lorsque la condition d’erreur est terminée (lorsqu’un code confidentiel est entré). Ensuite, le service Haut débit mobile appellera la méthode OnPacketServiceStateChange de IMbnRegistrationEvents.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |