Partager via


Méthode IMbnRegistration::GetRegisterState (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 d’inscription.

Syntaxe

HRESULT GetRegisterState(
  [out] MBN_REGISTER_STATE *registerState
);

Paramètres

[out] registerState

Pointeur MBN_REGISTER_STATE valeur qui spécifie l’état d’inscription actuel de l’appareil. La valeur n’est significative que si la méthode retournée S_OK.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
S_OK
L'opération a réussi.
E_PENDING
L’état d’inscription n’est pas disponible. Le service haut débit mobile sonde actuellement l’appareil pour obtenir des informations. Lorsque l’état d’inscription est disponible, le service Haut débit mobile appelle la méthode OnRegisterStateChange de IMbnRegistrationEvents.
E_MBN_PIN_REQUIRED
Un code confidentiel est requis pour obtenir l’état de l’inscription.

Notes

La méthode GetRegisterState obtient l’état d’inscription réseau actuel de l’appareil. L’appareil peut être inscrit sur un réseau, rechercher l’inscription sur le réseau ou refuser l’inscription.

L’état d’inscription de l’appareil peut changer automatiquement. Par exemple, lorsque l’appareil sort de la zone de couverture réseau, il change l’état d’inscription de MBN_REGISTER_STATE_HOME en MBN_REGISTER_STATE_SEARCHING.

Une application peut s’inscrire pour recevoir des mises à jour de modification de l’état d’inscription en connectant l’interface IMbnRegistrationEvents . Windows appelle la méthode OnRegisterStateChange de IMbnRegistrationEvents pour informer l’application de ces modifications.

Pour le E_MBN_PIN_REQUIRED d’erreur récupérable, 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, il appelle la méthode OnRegisterStateChange de IMbnRegistrationEvents.

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

Voir aussi

IMbnRegistration