XNetworkingConnectivityHint
네트워크 연결 수준, 데이터 제한, 인터페이스 유형, 네트워크 초기화 상태를 포함하여 네트워크의 현재 디바이스 전체 상태를 정의합니다.구문
멤버
connectivityLevel형식: XNetworkingConnectivityLevelHint 디바이스의 현재 최선의 노력(best-effort) 연결 수준입니다. connectivityCost
형식: XNetworkingConnectivityCostHint 디바이스의 데이터 제한에 대한 현재 최선의 노력(best-effort) 분류입니다. ianaInterfaceType
형식: uint32_t 인터넷에 도달하기 위해 WinSock과 WinHTTP가 사용할 가능성이 높은 현재 인터페이스 유형입니다. IANA NDIS 인터페이스 유형 중 하나입니다. networkInitialized
형식: bool 네트워크가 현재 초기화되었는지 여부를 결정합니다. 자세한 내용은 네트워크 정보 검색의 네트워크 초기화 섹션을 참조하세요. approachingDataLimit
형식: bool 디바이스가 데이터 제한 초과에 가까워졌는지 여부를 결정합니다. overDataLimit
형식: bool 디바이스가 데이터 제한을 초과했는지 여부를 결정합니다. roaming
형식: bool 디바이스가 로밍 중인지 여부를 결정합니다.
설명
네트워킹 또는 보안 API를 사용하기 전에 networkInitialized 멤버가 true를 반환하는지 확인하세요.네트워크가 초기화되지 않은 상태에서 XNetworking API를 사용하려고 하면 호출이 실패하고 예측할 수 없는 동작이 발생합니다.
XNetworkingConnectivityHint 구조체의 필드(XNetworkingConnectivityHint::networkInitialized 필드 제외)는 힌트입니다. 이는 디바이스의 네트워크 트래픽 요약을 기반으로 디바이스가 네트워크의 현재 상태에 대해 최선의 노력으로 추정한 값입니다. 중요한 점은 이러한 필드가 특정 타이틀 엔드포인트에 대한 연결 가능성을 나타내지는 않는다는 것입니다. 네트워크 초기화를 기다린 후에는 XNetworkingConnectivityHint::connectivityLevelHint 필드의 상태와 관계없이 WinSock 및/또는 WinHTTP를 사용해 엔드포인트에 연결을 시도할 것을 권장합니다. 이러한 API가 이후에 실패하면 추가 UI 및 진단 보고 목적으로 XNetworkingGetConnectivityHint API를 사용할 것을 권장합니다. 그런 다음 네트워크 연결 수준의 변경을 기다린 후 다시 시도해야 합니다.