WiFiAdapter 클래스

정의

네임스페이스:

Windows.Devices.WiFi

참고

일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

중요

이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요.

이 클래스를 사용하여 로컬 Wi-Fi 어댑터를 열거하고, Wi-Fi 검사를 시작하고, 검사 결과를 열거하고, 개별 어댑터를 연결하거나 연결을 끊을 수 있습니다.

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

상속

Object Platform::Object IInspectable WiFiAdapter

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

코드는 이 클래스의 정적 메서드를 사용합니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1709	16299	ConnectAsync(WiFiAvailableNetwork,WiFiReconnectionKind,PasswordCredential,String,WiFiConnectionMethod)
1709	16299	GetWpsConfigurationAsync

속성

NetworkAdapter	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. Wi-Fi 어댑터에 대한 정보를 가져옵니다.
NetworkReport	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 이 WiFiNetworkAdapter의 마지막 Wi-Fi 검사로 채워진 사용 가능한 네트워크 목록을 가져옵니다.

메서드

ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind)	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 지정된 다시 연결 정책을 사용하여 이 Wi-Fi 디바이스를 지정된 네트워크에 연결합니다.
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential)	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 지정된 암호 및 다시 연결 정책을 사용하여 이 Wi-Fi 디바이스를 지정된 네트워크에 연결합니다.
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String)	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 지정된 암호 및 다시 연결 정책을 사용하여 이 Wi-Fi 디바이스를 숨겨진 네트워크에 연결합니다.
ConnectAsync(WiFiAvailableNetwork, WiFiReconnectionKind, PasswordCredential, String, WiFiConnectionMethod)	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 지정된 암호, 연결 방법 및 다시 연결 정책을 사용하여 이 Wi-Fi 디바이스를 숨겨진 네트워크에 연결합니다.
Disconnect()	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 이 어댑터를 통해 활성 Wi-Fi 연결을 끊습니다.
FindAllAdaptersAsync()	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 시스템의 모든 Wi-Fi 어댑터를 열거하기 위해 비동기 작업을 시작하는 정적 메서드입니다. 앱 매니페스트에 wiFiControl 기능이 앱에 있음을 지정하지 않으면 이 메서드가 실패합니다.
FromIdAsync(String)	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. WiFiAdapter 개체를 가져오기 위해 비동기 작업을 시작하는 정적 메서드입니다. 앱 매니페스트에 wiFiControl 기능이 앱에 있음을 지정하지 않으면 이 메서드가 실패합니다.
GetDeviceSelector()	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. Windows.Devices.Enumeration.DeviceInformation.FindAllAsync 및 관련 메서드를 사용하여 Wi-Fi 어댑터를 열거하는 데 사용할 AQS(고급 쿼리 구문) 문자열을 반환하는 정적 메서드입니다.
GetWpsConfigurationAsync(WiFiAvailableNetwork)	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. WPS 검색을 수행하여 네트워크에서 지원하는 WPS 메서드를 쿼리합니다.
RequestAccessAsync()	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 현재 사용자가 이 디바이스의 Wi-Fi 어댑터에 액세스할 수 있는지 여부를 결정하는 정적 방법입니다. 앱 매니페스트에서 앱에 wiFiControl 기능이 있음을 지정하지 않으면 이 메서드는 항상 DeniedBySystem을 반환합니다. 항상 Xbox에서 DeniedBySystem 을 반환합니다.
ScanAsync()	참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 이 어댑터에 비동기 네트워크 검사를 시작하도록 지시합니다.

이벤트

AvailableNetworksChanged

참고 일부 정보는 상업용으로 출시되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다. 중요 이 API는 2024년 가을에 예정된 운영 체제 동작에 대한 향후 변경 내용의 영향을 받습니다. 자세한 내용은 Wi-Fi 액세스 및 위치에 대한 API 동작 변경을 참조하세요. 이 Wi-Fi 어댑터에서 검사가 완료될 때 발생하는 이벤트입니다. 이 이벤트는 백그라운드 작업에서 발생할 수 없습니다.