Méthode IMbnConnection::Connect (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.

Établit une connexion de données.

Syntaxe

HRESULT Connect(
  [in]  MBN_CONNECTION_MODE connectionMode,
  [in]  LPCWSTR             strProfile,
  [out] ULONG               *requestID
);

Paramètres

[in] connectionMode

Valeur MBN_CONNECTION_MODE qui spécifie le mode de connexion.

[in] strProfile

Contient l’identificateur de profil.

[out] requestID

Pointeur vers un ID de demande unique retourné par le service haut débit mobile pour identifier cette demande asynchrone.

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.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Le service haut débit mobile n’est pas en cours d’exécution sur ce système.
E_HANDLE	Interface non valide. Très probablement, l’appareil haut débit mobile a été supprimé du système.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Interface non valide. Très probablement, l’appareil haut débit mobile a été supprimé du système.
E_INVALIDARG	Un nom de profil non valide a été spécifié ou l’argument strProfile n’est pas conforme au schéma de profil XML
E_MBN_MAX_ACTIVATED_CONTEXTS	Il existe déjà un contexte haut débit mobile actif. Plusieurs contextes actifs ne sont pas pris en charge.

Notes

La méthode Connect est utilisée pour activer un contexte de connexion pour l’appareil. Le service haut débit mobile prend actuellement en charge au maximum un contexte actif. L’activation du contexte entraîne également l’établissement d’une connexion L2. De même, la désactivation d’un contexte entraîne la déconnexion de la connexion de données physiques au réseau mobile.

Si l’appareil n’est pas dans l’état attaché à des paquets au moment de l’appel de cette opération, le service haut débit mobile l’attache implicitement par paquets avant d’émettre la demande de connexion à l’appareil. En cas de modification de l’état du service de paquets, l’application est avertie par un appel à la méthode OnPacketServiceStateChange de l’interface IMbnRegistrationEvents .

Si connectionMode est défini sur MBN_CONNECTION_MODE_PROFILE, strProfile représente le nom du profil de l’appareil. Si la valeur est MBN_CONNECTION_MODE_TMP_PROFILE, strProfile représente la représentation XML du profil. Une application appelante peut utiliser IMbnConnectionProfileManager pour obtenir la liste des profils de connexion stockés dans l’appareil.

Il s’agit d’une opération asynchrone qui retourne immédiatement. Si cette méthode retourne correctement, le service haut débit mobile appelle la méthode OnConnectComplete de IMbnConnectionEvents une fois l’opération terminée.

Windows 8 et versions ultérieures de Windows : une application du Windows Store peut utiliser Connect avec uniquement le MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode et le paramètre strProfile défini sur une représentation XML du profil. Cela implique que la connexion est de nature temporaire et qu’elle n’est pas enregistrée pour une utilisation ultérieure par le système.

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

IMbnConnection

Partager via