WiFiOnDemandHotspotNetwork Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 WiFiOnDemandHotspotNetworkPublic NotInheritable Class WiFiOnDemandHotspotNetwork- Vererbung
- Attribute
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. |
Gilt für:
Weitere Informationen
- <xref:%0a%0a-+%5bWiFiOnDemandHotspotUpdateMetadataTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotupdatemetadatatrigger)%0a-+%5bWiFiOnDemandHotspotConnectTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotconnecttrigger)>
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für