Méthode IMbnConnectionEvents::OnConnectComplete (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 qui signale l’achèvement d’une opération de connexion.

Syntaxe

HRESULT OnConnectComplete(
  [in] IMbnConnection *newConnection,
  [in] ULONG          requestID,
  [in] HRESULT        status
);

Paramètres

[in] newConnection

Interface IMbnConnection qui représente l’appareil sur lequel l’opération de connexion s’est terminée.

[in] requestID

ID de demande attribué par le service Haut débit mobile pour identifier l’opération de connexion.

[in] status

Status d’achèvement.

Une application appelante peut s’attendre à l’une des valeurs suivantes.

Valeur	Signification
S_OK	L'opération a réussi.
E_MBN_SIM_NOT_INSERTED	Il n’y a pas de carte SIM dans l’appareil.
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	Le fournisseur n’est pas visible. Cela s’applique uniquement au mode d’inscription manuelle.
E_MBN_INVALID_ACCESS_STRING	La chaîne d’accès à la connexion n’est pas correcte.
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)	Le nom ou le mot de passe utilisé dans le profil de connexion n’est pas correct.
E_MBN_VOICE_CALL_IN_PROGRESS	Un appel vocal actif est en cours.
E_MBN_MAX_ACTIVATED_CONTEXTS	Un contexte haut débit mobile est déjà actif. Actuellement, le service Haut débit mobile ne prend pas en charge plusieurs contextes actifs.
E_MBN_RADIO_POWER_OFF	La radio de l’appareil est désactivée.
E_MBN_PACKET_SVC_DETACHED	Aucun service de paquets attaché actif n’est disponible.
E_MBN_ACTIVE_CONNECTION	L’appareil est déjà connecté au réseau.

Valeur retournée

Cette méthode doit retourner S_OK.

Notes

Une fois qu’un contexte d’activation est établi, une application peut utiliser IMbnConnection pour obtenir l’état actuel de la connexion.

Lorsque l’opération de connexion génère une erreur, une application peut appeler la méthode GetActivationNetworkError de l’interface IMbnConnection pour obtenir des informations sur l’erreur réseau.

Configuration requise


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

IMbnConnectionEvents

Partager via