다음을 통해 공유

WiFiOnDemandHotspotNetwork 클래스

  • 참조

정의

네임스페이스:
Windows.Devices.WiFi
편집

참고

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

중요

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

주문형 핫스팟을 지원하는 디바이스를 나타냅니다. 앱은 해당 디바이스를 OS(운영 체제)에 등록합니다. 여기서 앱은 모바일 핫스팟을 원격으로 사용하도록 설정할 수 있습니다. 이 개체의 속성을 업데이트하면 앱이 OS에 신호를 전송하여 UI(사용자 인터페이스)를 업데이트할 수 있습니다. 개체는 디바이스( ID 속성)를 식별하기 위한 호출자 선택 GUID(Globally Unique Identifier)에 키가 지정됩니다.

참고

UWP 앱에서 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (주문형 네트워크 기능)을 사용하기 위해 특별한 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

주문형 네트워크 기능은 테더링 가능 하드웨어 디바이스와 Windows PC 간에 엔드투엔드 Wi-Fi 핫스팟 시나리오를 빌드하는 앱 개발자만 사용할 수 있습니다.

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 WiFiOnDemandHotspotNetwork
Public NotInheritable Class WiFiOnDemandHotspotNetwork
상속
Object Platform::Object IInspectable WiFiOnDemandHotspotNetwork
특성
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리
Windows 11 Insider Preview (10.0.23504.0에서 도입되었습니다.)
API contract
Windows.Foundation.UniversalApiContract (v15.0에서 도입되었습니다.)
앱 기능
onDemandHotspotControl

예제

주문형 핫스팟 샘플

설명

주문형 핫스팟 은 Windows 클라이언트 디바이스가 호스트 Windows 디바이스(PC 또는 휴대폰)에서 모바일 핫스팟/인터넷 공유 액세스 지점을 보고 원격으로 사용하도록 설정하고 연결할 수 있는 Windows의 기능입니다. 이를 통해 클라이언트 디바이스는 호스트 디바이스의 인터넷 연결을 공유할 수 있습니다. 이 기능은 사용자가 Wi-Fi 빠른 설정을 열거나 사용 가능한 네트워크(Windows 11)를 Wi-Fi 때 Wi-Fi 네트워크를 클라이언트의 네트워크 목록에 삽입하여 사용자에게 노출됩니다.

앱은 이 API 외부에서 메타데이터를 가져오기 위해 핫스팟과 통신하는 방법을 결정합니다.

속성

Id

참고

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

중요

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

핫스팟을 식별하기 위한 호출자가 선택한 GUID(Globally Unique Identifier)입니다.

참고

UWP 앱에서 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (주문형 네트워크 기능)을 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

주문형 네트워크 기능은 테더링 가능 하드웨어 디바이스와 Windows PC 간에 엔드투엔드 Wi-Fi 핫스팟 시나리오를 빌드하는 앱 개발자만 사용할 수 있습니다.

메서드

GetOrCreateById(Guid)

참고

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

중요

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

OS(운영 체제)가 호출 앱의 핫스팟으로 이미 구성된 경우 GetOrCreateById는 지정된 networkId에 해당하는 WiFiOnDemandHotspotNetwork 개체를 검색합니다. 그렇지 않으면 메서드는 해당 ID에 대한 새 네트워크를 만듭니다.

참고

UWP 앱에서 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (주문형 네트워크 기능)을 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

주문형 네트워크 기능은 테더링 가능 하드웨어 디바이스와 Windows PC 간에 엔드투엔드 Wi-Fi 핫스팟 시나리오를 빌드하는 앱 개발자만 사용할 수 있습니다.
GetProperties()

참고

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

중요

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

WiFiOnDemandHotspotNetwork 개체에서 배터리 백분율, 표시 이름, 가용성 및 SSID/암호와 같은 핫스팟 네트워크의 다양한 속성을 검색합니다.

참고

UWP 앱에서 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (주문형 네트워크 기능)을 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

주문형 네트워크 기능은 테더링 가능 하드웨어 디바이스와 Windows PC 간에 엔드투엔드 Wi-Fi 핫스팟 시나리오를 빌드하는 앱 개발자만 사용할 수 있습니다.
UpdateProperties(WiFiOnDemandHotspotNetworkProperties)

참고

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

중요

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

WiFiOnDemandHotspotNetwork 개체의 배터리 백분율, 표시 이름, 가용성 및 SSID/암호와 같은 핫스팟 네트워크의 다양한 속성을 설정합니다. 속성이 잘못된 경우 UpdateProperties 는 잘못된 인수 예외를 throw합니다.

참고

UWP 앱에서 이 API를 사용하고 앱을 Microsoft Store에 게시하려면 사용자 지정 기능 Microsoft.onDemandHotspotControl_8wekyb3d8bbwe (주문형 네트워크 기능)을 사용하도록 특별 승인을 요청해야 합니다. 자세한 내용은 사용자 지정 기능을 참조하세요.

주문형 네트워크 기능은 테더링 가능 하드웨어 디바이스와 Windows PC 간에 엔드투엔드 Wi-Fi 핫스팟 시나리오를 빌드하는 앱 개발자만 사용할 수 있습니다.

적용 대상

추가 정보

  • <xref:%0a%0a-+%5bWiFiOnDemandHotspotUpdateMetadataTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotupdatemetadatatrigger)%0a-+%5bWiFiOnDemandHotspotConnectTrigger%5d(%2fuwp%2fapi%2fwindows.applicationmodel.background.wifiondemandhotspotconnecttrigger)>