IMbnConnection::Connect-Methode (mbnapi.h)

Artikel
08/24/2023

Wichtig

Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.

Stellt eine Datenverbindung her.

Syntax

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

Parameter

[in] connectionMode

Ein MBN_CONNECTION_MODE Wert, der den Modus der Verbindung angibt.

[in] strProfile

Enthält den Profil-Bezeichner.

[out] requestID

Ein Zeiger auf eine eindeutige Anforderungs-ID, die vom Mobilen Breitbanddienst zurückgegeben wird, um diese asynchrone Anforderung zu identifizieren.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde durchgeführt.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt.
E_HANDLE	Ungültige Schnittstelle. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Ungültige Schnittstelle. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
E_INVALIDARG	Es wurde ein ungültiger Profilname angegeben, oder das Argument strProfile ist nicht mit dem XML-Profilschema kompatibel.
E_MBN_MAX_ACTIVATED_CONTEXTS	Es gibt bereits einen aktiven Kontext für mobiles Breitband. Mehrere aktive Kontexte werden nicht unterstützt.

Hinweise

Die Connect-Methode wird verwendet, um einen Verbindungskontext für das Gerät zu aktivieren. Der mobile Breitbanddienst unterstützt derzeit höchstens einen aktiven Kontext. Die Aktivierung des Kontexts führt auch dazu, dass auch eine L2-Verbindung hergestellt wird. Ebenso führt die Deaktivierung eines Kontexts dazu, dass die physische Datenverbindung mit dem Mobilfunknetz getrennt wird.

Wenn sich das Gerät zum Zeitpunkt des Aufrufs dieses Vorgangs nicht im paketgebundenen Zustand befindet, bindet der Mobile Broadband-Dienst das Gerät implizit an, bevor die Verbindungsanforderung an das Gerät ausgegeben wird. Wenn sich der Zustand des Paketdiensts ändert, wird die Anwendung durch einen Aufruf der OnPacketServiceStateChange-Methode der IMbnRegistrationEvents-Schnittstelle benachrichtigt.

Wenn connectionMode auf MBN_CONNECTION_MODE_PROFILE festgelegt ist, stellt strProfile den Namen des Profils für das Gerät dar. Wenn auf MBN_CONNECTION_MODE_TMP_PROFILE festgelegt ist, stellt strProfile die XML-Darstellung des Profils dar. Eine aufrufende Anwendung kann IMbnConnectionProfileManager verwenden, um eine Liste der auf dem Gerät gespeicherten Verbindungsprofile abzurufen.

Dies ist ein asynchroner Vorgang, der sofort zurückgegeben wird. Wenn diese Methode erfolgreich zurückgegeben wird, ruft der Mobile Broadband-Dienst die OnConnectComplete-Methode von IMbnConnectionEvents auf, wenn der Vorgang abgeschlossen ist.

Windows 8 und höhere Versionen von Windows: Eine Windows Store-App kann Connect verwenden, wobei nur die MBN_CONNECTION_MODE_TMP_PROFILEconnectionMode und der strProfile-Parameter auf eine XML-Darstellung des Profils festgelegt sind. Dies impliziert, dass die Verbindung vorübergehender Natur ist und nicht für die zukünftige Verwendung durch das System gespeichert wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnConnection

Freigeben über