> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XNetworkingGetConnectivityHint

> XNetworkingGetConnectivityHint

# XNetworkingGetConnectivityHint

현재 네트워크 연결 수준, 데이터 제한, 인터페이스 유형 및 네트워크 초기화 상태에 대한 디바이스 전체 정보를 쿼리합니다.

## 구문

```cpp theme={null}
HRESULT XNetworkingGetConnectivityHint(
         XNetworkingConnectivityHint* connectivityHint
)
```

### 매개 변수

*connectivityHint*   \_Out\_<br />형식: [XNetworkingConnectivityHint](/reference/networking/xnetworking/structs/xnetworkingconnectivityhint)\*

네트워크의 현재 디바이스 전체 상태입니다.

### 반환 값

형식: HRESULT

HRESULT 성공 또는 오류 코드입니다.

## 설명

이 함수는 네트워크 연결 수준, 데이터 제한, 유선/무선 연결 여부, 그리고 네트워크가 초기화되었는지 여부에 대한 디바이스 전체 정보를 반환합니다. 변경 사항은 [XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged) 및 [XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged) 함수를 사용해 수신 대기할 수 있습니다.

반환된 `XNetworkingConnectivityHint` 구조체의 필드(`XNetworkingConnectivityHint::networkInitialized` 필드 제외)는 힌트입니다. 이는 디바이스의 네트워크 트래픽 요약을 기반으로 디바이스가 네트워크의 현재 상태에 대해 최선의 노력으로 추정한 값입니다. 중요한 점은 이러한 필드가 특정 타이틀 엔드포인트에 대한 연결 가능성을 나타내지는 않는다는 것입니다. 네트워크 초기화를 기다린 후에는 `XNetworkingConnectivityHint::connectivityLevelHint` 필드의 상태와 관계없이 WinSock 및/또는 WinHTTP를 사용해 엔드포인트에 연결을 시도할 것을 권장합니다. 이러한 API가 이후에 실패하면 추가 UI 및 진단 보고 목적으로 `XNetworkingGetConnectivityHint` API를 사용할 것을 권장합니다. 그런 다음 네트워크 연결 수준의 변경을 기다린 후 다시 시도해야 합니다.

네트워크 초기화에 대한 자세한 내용은 [네트워크 초기화 및 연결](/build/console-features/networking/initialization-connectivity-networking)을 참조하세요.

이 메서드는 호출 프로세스 내의 로컬 상태를 조사하고 빠르게 반환하므로, 시간에 민감한 컨텍스트에서 호출해도 안전합니다.

## 요구 사항

**헤더:** XNetworking.h

**라이브러리:** xgameruntime.lib

**지원 플랫폼:** Windows, XBOX One 제품군 콘솔 및 XBOX Series 콘솔

## 함께 보기

[XNetworkingRegisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged)<br />[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)<br />[네트워크 초기화 상태 감지](/build/console-features/networking/initialization-connectivity-networking)<br />[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingRegisterConnectivityHintChanged](/ko/reference/networking/xnetworking/functions/xnetworkingregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHintChangedCallback](/ko/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingUnregisterConnectivityHintChanged](/ko/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingConnectivityHint](/ko/reference/networking/xnetworking/structs/xnetworkingconnectivityhint.md)
- [네트워크 초기화 상태 감지](/ko/build/console-features/networking/initialization-connectivity-networking.md)