> ## 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.

# XNetworkingRegisterConnectivityHintChanged

> XNetworkingRegisterConnectivityHintChanged

# XNetworkingRegisterConnectivityHintChanged

현재 네트워크 연결 수준, 데이터 제한, 인터페이스 유형 및 네트워크 초기화 상태에 대한 디바이스 전체 정보의 변경 사항에 타이틀을 등록합니다.

## 구문

```cpp theme={null}
HRESULT XNetworkingRegisterConnectivityHintChanged(
         XTaskQueueHandle queue,
         void* context,
         XNetworkingConnectivityHintChangedCallback* callback,
         XTaskQueueRegistrationToken* token
)
```

### 매개 변수

*queue*   \_In\_opt\_\
형식: XTaskQueueHandle

연결 힌트가 변경될 때 콜백을 배치할 큐입니다.

*context*   \_In\_opt\_\
형식: void\*

콜백에 전달할 선택적 컨텍스트 포인터입니다.

*callback*   \_In\_\
형식: XNetworkingConnectivityHintChangedCallback\*

연결 힌트가 변경될 때 호출할 함수입니다.

*token*   \_Out\_\
형식: [XTaskQueueRegistrationToken](/reference/system/xtaskqueue/structs/xtaskqueueregistrationtoken)\*

등록 해제 시 콜백을 식별하는 데 사용되는 토큰입니다.

### 반환 값

형식: HRESULT

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

## 설명

이 함수는 "연결 힌트 변경(connectivity hint changed)" 알림을 등록하고 초기 알림 콜백을 전송합니다.

콜백을 등록 해제하려면 [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 콘솔

## 함께 보기

[XNetworkingGetConnectivityHint](/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint)\
[XNetworkingUnregisterConnectivityHintChanged](/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged)\
[XNetworking](/reference/networking/xnetworking/xnetworking_members)


## Related topics

- [XNetworkingConnectivityHintChangedCallback](/ko/reference/networking/xnetworking/functions/xnetworkingconnectivityhintchangedcallback.md)
- [XNetworkingUnregisterConnectivityHintChanged](/ko/reference/networking/xnetworking/functions/xnetworkingunregisterconnectivityhintchanged.md)
- [XNetworkingGetConnectivityHint](/ko/reference/networking/xnetworking/functions/xnetworkinggetconnectivityhint.md)
- [네트워크 초기화 상태 감지](/ko/build/console-features/networking/initialization-connectivity-networking.md)
- [XNetworking](/ko/reference/networking/xnetworking/xnetworking_members.md)