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.
Méthode de notification appelée par le service haut débit mobile pour indiquer qu’il a terminé une opération d’inscription de jeu.
Syntaxe
HRESULT OnSetRegisterModeComplete(
[in] IMbnRegistration *newInterface,
[in] ULONG requestID,
[in] HRESULT status
);
Paramètres
[in] newInterface
Pointeur vers une interface IMbnRegistration qui représente l’appareil applicable. L’application de gestion peut utiliser cette interface pour obtenir l’état d’inscription actuel de l’appareil.
[in] requestID
ID de demande attribué par le service Haut débit mobile pour suivre l’opération d’inscription de jeu.
[in] status
Un code status qui indique le résultat de l’opération.
Une application appelante peut s’attendre à l’une des valeurs possibles.
| Valeur |
Signification |
-
S_OK
|
L'opération a réussi.
|
-
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
|
Il existe déjà une connexion réseau active. Le mode d’inscription ne peut pas être modifié lorsqu’il existe une connexion de données déjà établie. L’application doit d’abord déconnecter la connexion, puis essayer de modifier le mode d’inscription. Si l’appareil est déjà en mode demandé et connecté au fournisseur demandé, le code de retour est S_OK.
|
-
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
|
L’opération n’est pas prise en charge par l’appareil. Cela peut être retourné par des appareils qui ne prennent pas en charge le mode d’inscription demandé. Par exemple, un appareil CDMA retourne cette erreur lorsqu’il est demandé de passer en mode d’inscription manuelle.
|
-
E_FAIL
|
L'opération n'a pas pu être terminée. Plus d’informations sont disponibles dans le code d’erreur réseau.
|
-
E_INVALIDARG
|
Entrée du mode d’inscription non valide ou l’ID de fournisseur fourni en tant qu’entrée dépasse la longueur maximale de 7 caractères ou la classe de données fournie n’est pas valide. Le service Haut débit mobile n’envoie pas la demande à l’appareil lorsque des arguments non valides sont fournis dans l’entrée.
En mode d’inscription manuelle, cela indique que le fournisseur demandé est interdit.
|
-
E_MBN_PIN_REQUIRED
|
Un code confidentiel est nécessaire pour que l’opération se termine.
|
-
E_MBN_SERVICE_NOT_ACTIVATED
|
L’abonnement au service réseau a expiré.
|
-
E_MBN_PROVIDER_NOT_VISIBLE
|
Cela se produit uniquement lors du passage en mode d’inscription manuelle. Le commutateur réussit, mais le fournisseur demandé n’est pas visible. L’appareil s’inscrit auprès du fournisseur demandé lorsqu’il est visible.
|
Valeur retournée
Cette méthode doit retourner S_OK.
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
IMbnRegistrationEvents