Méthode IMbnRegistrationEvents::OnSetRegisterModeComplete (mbnapi.h)

Article
08/24/2023

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

Partager via