WiFiAdapter 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.

Verwenden Sie diese Klasse, um lokale Wi-Fi-Adapter aufzulisten, Wi-Fi Scans zu initiieren, Scanergebnisse aufzulisten und einzelne Adapter zu verbinden oder zu trennen.

public ref class WiFiAdapter sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class WiFiAdapter final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class WiFiAdapter

Public NotInheritable Class WiFiAdapter

Vererbung

Object Platform::Object IInspectable WiFiAdapter

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Ihr Code verwendet die statischen Methoden dieser Klasse.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1709	16299	ConnectAsync(WiFiAvailableNetwork,WiFiReconnectionKind,PasswordCredential,String,WiFiConnectionMethod)
1709	16299	GetWpsConfigurationAsync

Eigenschaften

NetworkAdapter

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 Informationen zu einem Wi-Fi-Adapter ab.

NetworkReport

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 eine Liste der verfügbaren Netzwerke ab, die von der letzten Wi-Fi Überprüfung auf diesem WiFiNetworkAdapter aufgefüllt wurden.

Methoden

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind)	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. Verbinden Sie dieses Wi-Fi Gerät mit der angegebenen Richtlinie für die erneute Verbindung mit dem angegebenen Netzwerk.
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential)	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. Verbinden Sie dieses Wi-Fi Gerät mit dem angegebenen Netzwerk mit der angegebenen Passphrase und der richtlinie für die erneute Verbindung.
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String)	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. Verbinden Sie dieses Wi-Fi Gerät mit einem ausgeblendeten Netzwerk mit der angegebenen Passphrase und der richtlinie für die erneute Verbindung.
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String, WiFiConnectionMethod)	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. Verbinden Sie dieses Wi-Fi Gerät mit einem ausgeblendeten Netzwerk mit der angegebenen Passphrase, der angegebenen Verbindungsmethode und der richtlinie für die erneute Verbindung.
Disconnect()	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. Trennt alle aktiven Wi-Fi-Verbindungen über diesen Adapter.
FindAllAdaptersAsync()	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 statische Methode, die einen asynchronen Vorgang initiiert, um alle Wi-Fi Adapter im System aufzulisten. Beachten Sie, dass diese Methode fehlschlägt, wenn Sie nicht angeben, dass Ihre App über die wiFiControl-Funktion in Ihrem App-Manifest verfügt.
FromIdAsync(String)	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 statische Methode, die einen asynchronen Vorgang zum Abrufen eines WiFiAdapter-Objekts initiiert. Beachten Sie, dass diese Methode fehlschlägt, wenn Sie nicht angeben, dass Ihre App über die wiFiControl-Funktion in Ihrem App-Manifest verfügt.
GetDeviceSelector()	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 statische Methode, die eine AQS-Zeichenfolge (Advanced Query Syntax) zurückgibt, die zum Aufzählen Wi-Fi Adapter mithilfe von Windows.Devices.Enumeration.DeviceInformation.FindAllAsync und verwandten Methoden verwendet werden soll.
GetWpsConfigurationAsync(WiFiAvailableNetwork)	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. Führt die WPS-Ermittlung aus, um die vom Netzwerk unterstützten WPS-Methoden abzufragen.
RequestAccessAsync()	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 statische Methode zum Bestimmen, ob der aktuelle Benutzer auf einen der Wi-Fi Adapter auf diesem Gerät zugreifen kann. Wenn Sie nicht angeben, dass Ihre App über die wiFiControl-Funktion in Ihrem App-Manifest verfügt, gibt diese Methode immer DeniedBySystem zurück. Gibt immer DeniedBySystem auf xbox zurück.
ScanAsync()	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. Weist diesen Adapter an, eine asynchrone Netzwerküberprüfung zu initiieren.

Ereignisse

AvailableNetworksChanged

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. Das Ereignis wird ausgelöst, wenn eine Überprüfung auf diesem Wi-Fi Adapter abgeschlossen ist. Dieses Ereignis kann nicht von einer Hintergrundaufgabe ausgelöst werden.