IMbnRadio::SetSoftwareRadioState-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.

Legt den Softwarefunkstatus eines mobilen Breitbandgeräts fest.

Syntax

HRESULT SetSoftwareRadioState(
  [in]  MBN_RADIO radioState,
  [out] ULONG     *requestID
);

Parameter

[in] radioState

Ein MBN_RADIO Wert, der den neuen Softwarefunkzustand angibt.

[out] requestID

Ein Zeiger auf eine Anforderungs-ID, die vom Mobilen Breitbanddienst zugewiesen wurde, um diese Anforderung zu identifizieren.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde durchgeführt.
E_HANDLE	Die Schnittstelle ist ungültig. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	Die Schnittstelle ist ungültig. Höchstwahrscheinlich wurde das mobile Breitbandgerät aus dem System entfernt.
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	Der mobile Breitbanddienst wird auf diesem System nicht ausgeführt.

Hinweise

SetSoftwareRadioState ändert den Softwarefunkstatus des Geräts. Dies ist ein asynchroner Vorgang, der sofort zurückgegeben wird. Nach Abschluss ruft der Mobile Broadband-Dienst die OnSetSoftwareRadioStateComplete-Methode der IMbnRadioEvents-Schnittstelle auf.

Das Deaktivieren des Funkgeräts für ein mobiles Breitbandgerät führt zur Deaktivierung jeder aktiven Verbindung, zum Trennen von Netzwerkpaketen und zur Deregistrierung des Netzwerks. Wenn der Funkvorgang zu einer Änderung des Verbindungszustands, des Paketanfügungsstatus oder des Netzwerkregistrierungsstatus führt, erhält die Anwendung eine Benachrichtigung über die Änderungen.

Wenn sowohl Software- als auch Hardwarefunk für ein mobiles Breitbandgerät aktiviert sind, versucht es automatisch, sich beim Netzwerk zu registrieren. Außerdem können einige Geräte auch versuchen, ein Paket an das Netzwerk anzufügen. Wenn sich der Zustand ändert, erhält die aufrufende Anwendung Ereignisbenachrichtigungen für die Netzwerkregistrierung und Änderungen des Paketanfügungsstatus.

Der Funkstatus eines Geräts kann sich ohne Änderungsanforderung der Anwendung ändern. Für instance, wenn ein Benutzer den Hardware-Funkschalter des Systems einschaltet. Der mobile Breitbanddienst benachrichtigt die Anwendung über eine Änderung des Funkzustands, indem die OnRadioStateChange-Methode der IMbnRadioEvents-Schnittstelle aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	mbnapi.h

Weitere Informationen

IMbnRadio

Freigeben über