NetworkOperatorTetheringManager.CreateFromConnectionProfile 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
오버로드
| CreateFromConnectionProfile(ConnectionProfile) |
지정된 프로필을 공용 인터페이스로 사용하고 프라이빗 인터페이스로 Wi-Fi 사용하여 NetworkOperatorTetheringManager 를 만듭니다. |
| CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter) |
지정된 프로필을 공용 인터페이스로 사용하고 지정된 NetworkAdapter에서 프라이빗 인터페이스로 사용하여 NetworkOperatorTetheringManager를 만듭니다. |
CreateFromConnectionProfile(ConnectionProfile)
지정된 프로필을 공용 인터페이스로 사용하고 프라이빗 인터페이스로 Wi-Fi 사용하여 NetworkOperatorTetheringManager 를 만듭니다.
public:
static NetworkOperatorTetheringManager ^ CreateFromConnectionProfile(ConnectionProfile ^ profile); static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile);/// [Windows.Foundation.Metadata.Overload("CreateFromConnectionProfile")]
static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile);public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile);[Windows.Foundation.Metadata.Overload("CreateFromConnectionProfile")]
public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile);function createFromConnectionProfile(profile)Public Shared Function CreateFromConnectionProfile (profile As ConnectionProfile) As NetworkOperatorTetheringManager매개 변수
- profile
- ConnectionProfile
사용할 연결 프로필입니다.
반환
결과 관리자 개체입니다.
- 특성
Windows 요구 사항
| 앱 기능 |
wiFiControl
|
설명
이전 릴리스에서는 네트워크 운영자의 권한 있는 앱만 NetworkOperatorTetheringManager 개체를 만들고 이를 사용하여 테더링을 제어할 수 있었습니다. 이 릴리스에서 모든 앱은 CreateFromConnectionProfile을 호출하여 개체를 만들 수 있습니다. 그러나 호출이 성공하려면 앱에 해당 매니페스트에 선언된 적절한 Wi-Fi 제어 디바이스 기능이 있어야 합니다. 다음 예제에서는 wiFiControl 특성이 있는 필요한 DeviceCapability 태그가 있는 매니페스트의 일부를 보여 줍니다.
<Capabilities>
<DeviceCapability Name="wiFiControl"/>
</Capabilities>
wiFiControl 디바이스 기능이 매니페스트에 설정되지 않은 경우 예외를 throw하여 CreateFromConnectionProfile에 대한 호출이 실패합니다.
코드는 GetTetheringCapabilityFromConnectionProfile을 호출하여 런타임에 기능이 설정되는지 여부를 확인할 수 있습니다. DisabledBySystemCapability가 반환되면 매니페스트가 필요한 디바이스 기능을 설정하지 않습니다. Enabled가 반환되더라도 테더링 기능은 언제든지 앱의 제어 또는 알림 외부에서 변경될 수 있으므로 오류 및 예외를 처리하도록 코드를 작성해야 합니다.
추가 정보
적용 대상
CreateFromConnectionProfile(ConnectionProfile, NetworkAdapter)
지정된 프로필을 공용 인터페이스로 사용하고 지정된 NetworkAdapter에서 프라이빗 인터페이스로 사용하여 NetworkOperatorTetheringManager를 만듭니다.
public:
static NetworkOperatorTetheringManager ^ CreateFromConnectionProfile(ConnectionProfile ^ profile, NetworkAdapter ^ adapter);/// [Windows.Foundation.Metadata.Overload("CreateFromConnectionProfileWithTargetAdapter")]
static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile const& profile, NetworkAdapter const& adapter);[Windows.Foundation.Metadata.Overload("CreateFromConnectionProfileWithTargetAdapter")]
public static NetworkOperatorTetheringManager CreateFromConnectionProfile(ConnectionProfile profile, NetworkAdapter adapter);function createFromConnectionProfile(profile, adapter)Public Shared Function CreateFromConnectionProfile (profile As ConnectionProfile, adapter As NetworkAdapter) As NetworkOperatorTetheringManager매개 변수
- profile
- ConnectionProfile
사용할 연결 프로필입니다.
- adapter
- NetworkAdapter
연결이 공유되는 네트워크 어댑터입니다. 공유 연결은 NetworkOperatorTetheringManager에 의해 제어됩니다.
반환
결과 관리자 개체입니다.
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 Anniversary Edition (10.0.14393.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v3.0에서 도입되었습니다.)
|
| 앱 기능 |
wiFiControl
|
설명
이전 릴리스에서는 네트워크 운영자의 권한 있는 앱만 NetworkOperatorTetheringManager 개체를 만들고 이를 사용하여 테더링을 제어할 수 있었습니다. 이 릴리스에서 모든 앱은 CreateFromConnectionProfile을 호출하여 개체를 만들 수 있습니다. 그러나 호출이 성공하려면 앱에 해당 매니페스트에 선언된 적절한 Wi-Fi 제어 디바이스 기능이 있어야 합니다. 다음 예제에서는 wiFiControl 특성이 있는 필요한 DeviceCapability 태그가 있는 매니페스트의 일부를 보여 줍니다.
<Capabilities>
<DeviceCapability Name="wiFiControl"/>
</Capabilities>
wiFiControl 디바이스 기능이 매니페스트에 설정되지 않은 경우 예외를 throw하여 CreateFromConnectionProfile에 대한 호출이 실패합니다.
코드는 GetTetheringCapabilityFromConnectionProfile을 호출하여 런타임에 기능이 설정되는지 여부를 확인할 수 있습니다. DisabledBySystemCapability가 반환되면 매니페스트가 필요한 디바이스 기능을 설정하지 않습니다. Enabled가 반환되더라도 테더링 기능은 언제든지 앱의 제어 또는 알림 외부에서 변경될 수 있으므로 오류 및 예외를 처리하도록 코드를 작성해야 합니다.