IMbnConnectionEvents::OnConnectComplete-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.

Benachrichtigungsmethode, die den Abschluss eines Verbindungsvorgangs signalisiert.

Syntax

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

Parameter

[in] newConnection

Eine IMbnConnection-Schnittstelle , die das Gerät darstellt, auf dem der Verbindungsvorgang abgeschlossen wurde.

[in] requestID

Die anforderungs-ID, die vom Mobilen Breitbanddienst zugewiesen wird, um den Verbindungsvorgang zu identifizieren.

[in] status

Der Abschluss status.

Eine aufrufende Anwendung kann einen der folgenden Werte erwarten.

Wert	Bedeutung
S_OK	Der Vorgang wurde durchgeführt.
E_MBN_SIM_NOT_INSERTED	Es gibt keine SIM-Karte im Gerät.
E_MBN_PIN_REQUIRED	Für den Abschluss des Vorgangs ist eine PIN erforderlich.
E_MBN_SERVICE_NOT_ACTIVATED	Das Netzwerkdienstabonnement ist abgelaufen.
E_MBN_PROVIDER_NOT_VISIBLE	Der Anbieter ist nicht sichtbar. Dies gilt nur für den manuellen Registrierungsmodus.
E_MBN_INVALID_ACCESS_STRING	Die Verbindungszugriffszeichenfolge ist nicht korrekt.
HRESULT_FROM_WIN32(ERROR_INVALID_PASSWORD)	Der Name oder das Kennwort, die im Verbindungsprofil verwendet wird, ist nicht korrekt.
E_MBN_VOICE_CALL_IN_PROGRESS	Ein aktiver Sprachanruf wird ausgeführt.
E_MBN_MAX_ACTIVATED_CONTEXTS	Es ist bereits ein Mobiler Breitbandkontext aktiv. Der mobile Breitbanddienst unterstützt derzeit nicht mehrere aktive Kontexte.
E_MBN_RADIO_POWER_OFF	Das Geräteradio ist ausgeschaltet.
E_MBN_PACKET_SVC_DETACHED	Es ist kein aktiver angefügter Paketdienst verfügbar.
E_MBN_ACTIVE_CONNECTION	Das Gerät ist bereits mit dem Netzwerk verbunden.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Sobald ein Aktivierungskontext eingerichtet wurde, kann eine Anwendung IMbnConnection verwenden, um den aktuellen Verbindungsstatus abzurufen.

Wenn der Verbindungsvorgang zu einem Fehler führt, kann eine Anwendung die GetActivationNetworkError-Methode der IMbnConnection-Schnittstelle aufrufen, um Netzwerkfehlerinformationen abzurufen.

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

IMbnConnectionEvents

Freigeben über