WiFiOnDemandHotspotNetwork Klasse

Definition

Namespace:

Windows.Devices.WiFi

Hinweis

Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Wichtig

Diese API wird von bevorstehenden Änderungen am Betriebssystemverhalten beeinflusst, die für Herbst 2024 geplant sind. Weitere Informationen finden Sie unter Änderungen am API-Verhalten für Wi-Fi Zugriff und Speicherort.

Stellt ein Gerät dar, das bedarfsgesteuerte Hotspots unterstützt. Die App registriert dieses Gerät beim Betriebssystem ( Os), wo die App den mobilen Hotspot remote aktivieren kann. Durch Aktualisieren der Eigenschaften für dieses Objekt kann die App dem Betriebssystem signalisieren, dass die Benutzeroberfläche aktualisiert wird. Das Objekt wird für einen vom Aufrufer ausgewählten global eindeutigen Bezeichner (GUID) schlüsselt, der das Gerät identifizieren soll (die Id-Eigenschaft ).

Hinweis

Wenn Sie diese API in einer UWP-App verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (die On-Demand-Netzwerkfunktion) zu verwenden. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen.

Die On-Demand-Netzwerkfunktion wird nur App-Entwicklern zur Verfügung gestellt, die End-to-End-Wi-Fi Hotspot-Szenarien zwischen einem Tethering-fähigen Hardwaregerät und einem Windows-PC erstellen.

public ref class WiFiOnDemandHotspotNetwork sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 983040)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class WiFiOnDemandHotspotNetwork final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 983040)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class WiFiOnDemandHotspotNetwork

Public NotInheritable Class WiFiOnDemandHotspotNetwork

Vererbung

Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows-Anforderungen

Gerätefamilie	Windows 11 Insider Preview (eingeführt in 10.0.23504.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v15.0)
App-Funktionen	onDemandHotspotControl

Beispiele

Beispiel für einen bedarfsgesteuerten Hotspot

Hinweise

Bei einem Bedarfs-Hotspot handelt es sich um das Feature in Windows, mit dem ein Windows-Clientgerät den mobilen Hotspot/Internetfreigabezugriffspunkt auf einem Windows-Hostgerät (pc oder telefon) anzeigen und remote aktivieren und eine Verbindung damit herstellen kann. Dadurch kann das Clientgerät die Internetverbindung des Hostgeräts gemeinsam nutzen. Diese Funktionalität wird für den Benutzer verfügbar gemacht, indem ein Wi-Fi Netzwerk in die Netzwerkliste des Clients eingefügt wird, wenn der Benutzer die Wi-Fi Schnelleinstellungen oder Wi-Fi verfügbaren Netzwerke (Windows 11) der Systemeinstellungen öffnet.

Die App ist dafür verantwortlich, zu bestimmen, wie mit dem Hotspot kommuniziert wird, um die Metadaten außerhalb dieser API abzurufen.

Eigenschaften

Id

Hinweis Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent. Wichtig Diese API wird von bevorstehenden Änderungen am Betriebssystemverhalten beeinflusst, die für Herbst 2024 geplant sind. Weitere Informationen finden Sie unter Änderungen am API-Verhalten für Wi-Fi Zugriff und Speicherort. Eine vom Aufrufer ausgewählte GUID (Globally Unique Identifier), die den Hotspot identifizieren soll. Hinweis Wenn Sie diese API in einer UWP-App verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (die On-Demand-Netzwerkfunktion) zu verwenden. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen. Die On-Demand-Netzwerkfunktion wird nur App-Entwicklern zur Verfügung gestellt, die End-to-End-Wi-Fi Hotspot-Szenarien zwischen einem Tethering-fähigen Hardwaregerät und einem Windows-PC erstellen.

Methoden

GetOrCreateById(Guid)	Hinweis Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent. Wichtig Diese API wird von bevorstehenden Änderungen am Betriebssystemverhalten beeinflusst, die für Herbst 2024 geplant sind. Weitere Informationen finden Sie unter Änderungen am API-Verhalten für Wi-Fi Zugriff und Speicherort. Wenn das Betriebssystem (Os) bereits mit einem Hotspot aus der aufrufenden App konfiguriert ist, ruft GetOrCreateById das WiFiOnDemandHotspotNetwork-Objekt ab, das der angegebenen networkId entspricht. Andernfalls erstellt die -Methode ein neues Netzwerk für diese ID. Hinweis Wenn Sie diese API in einer UWP-App verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (die On-Demand-Netzwerkfunktion) zu verwenden. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen. Die On-Demand-Netzwerkfunktion wird nur App-Entwicklern zur Verfügung gestellt, die End-to-End-Wi-Fi Hotspot-Szenarien zwischen einem Tethering-fähigen Hardwaregerät und einem Windows-PC erstellen.
GetProperties()	Hinweis Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent. Wichtig Diese API wird von bevorstehenden Änderungen am Betriebssystemverhalten beeinflusst, die für Herbst 2024 geplant sind. Weitere Informationen finden Sie unter Änderungen am API-Verhalten für Wi-Fi Zugriff und Speicherort. Ruft aus einem WiFiOnDemandHotspotNetwork-Objekt verschiedene Eigenschaften des Hotspotnetzwerks ab, z. B. Akkuprozentsatz, Anzeigename, Verfügbarkeit und SSID/Kennwort. Hinweis Wenn Sie diese API in einer UWP-App verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (die On-Demand-Netzwerkfunktion) zu verwenden. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen. Die On-Demand-Netzwerkfunktion wird nur App-Entwicklern zur Verfügung gestellt, die End-to-End-Wi-Fi Hotspot-Szenarien zwischen einem Tethering-fähigen Hardwaregerät und einem Windows-PC erstellen.
UpdateProperties(WiFiOnDemandHotspotNetworkProperties)	Hinweis Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent. Wichtig Diese API wird von bevorstehenden Änderungen am Betriebssystemverhalten beeinflusst, die für Herbst 2024 geplant sind. Weitere Informationen finden Sie unter Änderungen am API-Verhalten für Wi-Fi Zugriff und Speicherort. Legt für ein WiFiOnDemandHotspotNetwork-Objekt verschiedene Eigenschaften des Hotspotnetzwerks fest, z. B. Akkuprozentsatz, Anzeigename, Verfügbarkeit und SSID/Kennwort. Wenn eine Eigenschaft ungültig ist, löst UpdateProperties eine Ungültige Argument-Ausnahme aus. Hinweis Wenn Sie diese API in einer UWP-App verwenden und Ihre App im Microsoft Store veröffentlichen möchten, müssen Sie eine spezielle Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (die On-Demand-Netzwerkfunktion) zu verwenden. Weitere Informationen finden Sie unter Benutzerdefinierte Funktionen. Die On-Demand-Netzwerkfunktion wird nur App-Entwicklern zur Verfügung gestellt, die End-to-End-Wi-Fi Hotspot-Szenarien zwischen einem Tethering-fähigen Hardwaregerät und einem Windows-PC erstellen.

Weitere Informationen

• <xref:%0a%0a-+%5bWiFiOnDemandHotspotUpdateMetadataTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotupdatemetadatatrigger)%0a-+%5bWiFiOnDemandHotspotConnectTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotconnecttrigger)>