WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) Methode

  • Referenz

Definition

Namespace:
Windows.Devices.WiFi
Bearbeiten

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 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 besondere Genehmigung anfordern, um die benutzerdefinierte Funktion Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (On-Demand Network-Funktion) 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:
 static WiFiOnDemandHotspotNetwork ^ GetOrCreateById(Platform::Guid networkId);
 static WiFiOnDemandHotspotNetwork GetOrCreateById(winrt::guid const& networkId);
public static WiFiOnDemandHotspotNetwork GetOrCreateById(Guid networkId);
function getOrCreateById(networkId)
Public Shared Function GetOrCreateById (networkId As Guid) As WiFiOnDemandHotspotNetwork

Parameter

networkId
Guid

Platform::Guid

winrt::guid

Der globally unique identifier (GUID), der ein WiFiOnDemandHotspotNetwork-Objekt identifiziert.

Gibt zurück

WiFiOnDemandHotspotNetwork

Das Objekt, das erstellt oder abgerufen wurde.

Windows-Anforderungen

App-Funktionen
onDemandHotspotControl

Hinweise

  • Die ID kann ein beliebiger Wert sein, den die App zur Unterscheidung mehrerer Bedarfs-Hotspots verwendet. Für eine optimale Leistung bei kurzlebigen Verbindungen empfiehlt es sich jedoch, dieselbe ID erneut zu verwenden und die SSID und das Kennwort zu aktualisieren, anstatt für jedes neue Netzwerk zu erstellen.
  • Die ID muss nur innerhalb einer App eindeutig sein.
  • Die aufrufende App muss über eine Paketidentität verfügen.

Gilt für: