ConnectionProfile 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
현재 연결된 네트워크 또는 이전 네트워크 연결을 포함하는 네트워크 연결을 나타냅니다. 연결 상태 및 연결 통계에 대한 정보를 제공합니다.
public ref class ConnectionProfile sealed/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class ConnectionProfile final[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class ConnectionProfilePublic NotInheritable Class ConnectionProfile- 상속
- 특성
Windows 요구 사항
| 디바이스 패밀리 |
Windows 10 (10.0.10240.0에서 도입되었습니다.)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)
|
설명
다음 예제 함수는 ConnectionProfile에서 데이터를 검색하는 방법을 보여 줍니다.
function getConnectionProfileInfo(connectionProfile) {
returnString += "Connection Cost Information:\n\r";
returnString += "===============\n\r";
var connectionCost = connectionProfile.getConnectionCost();
returnString += "Cost Type: " + getCostType(connectionCost.networkCostType) + "\n\r";
returnString += "Roaming: " + connectionCost.roaming + "\n\r";
returnString += "Over Datalimit: " + connectionCost.overDataLimit + "\n\r";
returnString += "Approaching Datalimit: " + connectionCost.approachingDataLimit + "\n\r";
}
연결 정보에 액세스하기 위해 이러한 클래스 메서드를 구현하는 방법에 대한 자세한 예제는 빠른 시작: 네트워크 연결 정보 검색을 참조하세요.
버전 기록
| Windows 버전 | SDK 버전 | 추가된 값 |
|---|---|---|
| 1709 | 16299 | GetProviderNetworkUsageAsync |
| 1809 | 17763 | CanDelete |
| 1809 | 17763 | TryDeleteAsync |
속성
| CanDelete |
이 연결 프로필을 삭제할 수 있는지 여부를 나타내는 값을 가져옵니다. 이렇게 하면 TryDeleteAsync 가 성공할 가능성이 있는지 여부를 확인할 수 있습니다. |
| IsWlanConnectionProfile |
연결 프로필이 WLAN(WiFi) 연결인지를 나타내는 값을 가져옵니다. 이렇게 하면 WlanConnectionProfileDetails 가 null인지 여부가 결정됩니다. |
| IsWwanConnectionProfile |
연결 프로필이 WWAN(모바일) 연결인지를 나타내는 값을 가져옵니다. 이렇게 하면 WwanConnectionProfileDetails 가 null인지 여부가 결정됩니다. |
| NetworkAdapter |
연결에 대한 연결을 제공하는 네트워크 어댑터를 나타내는 개체를 가져옵니다. |
| NetworkSecuritySettings |
네트워크에 대한 보안 설정을 검색합니다. |
| ProfileName |
연결 프로필의 이름을 가져옵니다. |
| ServiceProviderGuid |
연결 프로필을 프로비전한 네트워크 운영자의 ID를 가져옵니다. |
| WlanConnectionProfileDetails |
WLAN(WiFi) 연결과 관련된 정보를 검색하는 방법을 제공하는 WlanConnectionProfileDetails 개체를 가져옵니다. |
| WwanConnectionProfileDetails |
모바일 광대역 연결과 관련된 정보를 검색하는 데 사용되는 속성과 메서드를 포함하는 WwanConnectionProfileDetails 개체를 가져옵니다. |
메서드
| GetAttributedNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates) |
각 개별 애플리케이션에 대한 네트워크 사용량 데이터를 가져옵니다. |
| GetConnectionCost() |
연결에 대한 비용 정보를 가져옵니다. |
| GetConnectivityIntervalsAsync(DateTime, DateTime, NetworkUsageStates) |
네트워크 연결이 시작된 시점의 타임스탬프와 해당 연결 기간의 시간 범위를 나타내는 ConnectivityInterval 개체 목록을 가져옵니다. |
| GetDataPlanStatus() |
연결과 연결된 데이터 계획의 현재 상태 가져옵니다. |
| GetDomainConnectivityLevel() |
네트워크 연결에 대한 현재 도메인 인증 상태 가져옵니다. 가능한 값은 DomainConnectivityLevel에 의해 정의됩니다. |
| GetLocalUsage(DateTime, DateTime) |
참고 Windows 8.1 후 릴리스에서 GetLocalUsage를 변경하거나 사용할 수 없습니다. 대신 GetNetworkUsageAsync를 사용합니다. 특정 기간 동안의 연결에 대한 예상 데이터 사용량을 가져옵니다. |
| GetLocalUsage(DateTime, DateTime, RoamingStates) |
참고 Windows 8.1 후 릴리스에서 GetLocalUsage를 변경하거나 사용할 수 없습니다. 대신 GetNetworkUsageAsync를 사용합니다. 특정 기간 및 로밍 상태에 대한 연결의 예상 데이터 사용량을 가져옵니다. |
| GetNetworkConnectivityLevel() |
이 연결에 대한 네트워크 연결 수준을 가져옵니다. 이 값은 현재 사용할 수 있는 네트워크 리소스(있는 경우)를 나타냅니다. |
| GetNetworkNames() |
연결이 현재 설정된 네트워크와 연결된 이름을 검색합니다. |
| GetNetworkUsageAsync(DateTime, DateTime, DataUsageGranularity, NetworkUsageStates) |
특정 네트워크 사용 상태에 대해 지정된 기간 동안의 예상 데이터 트래픽 및 연결 기간 목록을 가져옵니다. DataUsageGranularity 는 반환된 데이터의 원하는 세분성을 나타내는 데 사용되며 반환된 목록의 길이에 영향을 줍니다. NetworkUsageStates 는 원하는 네트워크 사용 구성을 나타내는 데 사용됩니다. |
| GetProviderNetworkUsageAsync(DateTime, DateTime, NetworkUsageStates) |
각 MCC 및 MNC 조합에 대해 전송된 바이트 및 바이트를 반환합니다(이 조합은 ProviderId로 표현됨). |
| GetSignalBars() |
연결에 대해 Windows UI에서 표시하는 신호 막대의 현재 수를 나타내는 값을 가져옵니다. |
| IsDomainAuthenticatedBy(DomainAuthenticationKind) |
지정된 도메인 인증 방법이 이 연결 프로필에 성공했는지 여부를 쿼리합니다. |
| TryDeleteAsync() |
이 연결 프로필을 비동기적으로 삭제하려고 합니다. 작업이 성공하거나 성공하지 못할 수 있습니다. 반환 값을 검사하여 작업의 결과를 확인합니다. |