ConnectionProfile 클래스

  • 참조

정의

네임스페이스:
Windows.Networking.Connectivity
편집

현재 연결된 네트워크 또는 이전 네트워크 연결을 포함하는 네트워크 연결을 나타냅니다. 연결 상태 및 연결 통계에 대한 정보를 제공합니다.

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

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()

이 연결 프로필을 비동기적으로 삭제하려고 합니다. 작업이 성공하거나 성공하지 못할 수 있습니다. 반환 값을 검사하여 작업의 결과를 확인합니다.

적용 대상

추가 정보