Méthode IMbnConnection::Connect (mbnapi.h)

É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.

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

Voir aussi

IMbnConnection