WiFiOnDemandHotspotNetwork.UpdateProperties Methode

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.

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.

public:
 virtual void UpdateProperties(WiFiOnDemandHotspotNetworkProperties ^ newProperties) = UpdateProperties;

void UpdateProperties(WiFiOnDemandHotspotNetworkProperties const& newProperties);

public void UpdateProperties(WiFiOnDemandHotspotNetworkProperties newProperties);

function updateProperties(newProperties)

Public Sub UpdateProperties (newProperties As WiFiOnDemandHotspotNetworkProperties)

Parameter

newProperties

WiFiOnDemandHotspotNetworkProperties

Ein Objekt, das die festzulegenden Eigenschaften darstellt.

Windows-Anforderungen

App-Funktionen

onDemandHotspotControl

Hinweise

UpdateMetadata sollte regelmäßig von der App aufgerufen werden, auch wenn sich keine Eigenschaften geändert haben. Dadurch wird sichergestellt, dass Windows das Netzwerk in der Liste der Wi-Fi verfügbaren Netzwerke angezeigt wird (d. h. Windows blendet es nicht aus, da es veraltet ist). Es wird empfohlen, sich für die Hintergrundaufgabe WiFiOnDemandHotspotUpdateMetadataTrigger zu registrieren und dort aufzurufen UpdateMetadata .