WiFiOnDemandHotspotNetwork.GetOrCreateById(Guid) 메서드

  • 참조

정의

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

참고

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

중요

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

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

참고

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

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

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

매개 변수

networkId
Guid

Platform::Guid

winrt::guid

WiFiOnDemandHotspotNetwork 개체를 식별하는 GUID(Globally Unique Identifier)입니다.

반환

WiFiOnDemandHotspotNetwork

만들거나 검색한 개체입니다.

Windows 요구 사항

앱 기능
onDemandHotspotControl

설명

  • ID는 앱이 여러 주문형 핫스팟을 구분하는 데 사용하기로 선택한 값일 수 있습니다. 그러나 임시 연결을 사용하는 최상의 성능을 위해 각 연결에 대해 새 네트워크를 만드는 대신 동일한 ID를 재사용하고 SSID 및 암호를 업데이트하는 것이 좋습니다.
  • ID는 앱 내에서만 고유해야 합니다.
  • 호출 앱에는 패키지 ID가 있어야 합니다.

적용 대상