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

# PFSettingsSetTraceLevel

> PlayFabCore, PlayFabServices 및 PlayFabGameSave가 PlayFab 추적 영역에서 내보내는 추적 이벤트의 가장 자세한 수준을 설정합니다.

Microsoft Azure PlayFab 추적 영역의 이벤트에 대한 추적 수준을 설정합니다.

## 구문

```cpp theme={null}
HRESULT PFSettingsSetTraceLevel(  
    PFTraceLevel traceLevel  
)  
```

### 매개 변수

**`traceLevel`**   PFTraceLevel\
*In*

내보낼 최대 상세 수준입니다. 이 수준 및 이보다 덜 자세한 수준의 이벤트는 내보내지고, 더 자세한 이벤트는 삭제됩니다. 가장 덜 자세한 것부터 가장 자세한 것 순으로 `PFTraceLevel` 값은 `Off`(0), `Error`(1), `Warning`(2), `Important`(3), `Information`(4), `Verbose`(5)입니다. PlayFab 추적 영역의 모든 추적 이벤트를 삭제하려면 `PFTraceLevel::Off`를 전달하세요.

### 반환 값

형식: HRESULT

추적 수준이 설정되면 `S_OK`를 반환합니다. `traceLevel`이 `PFTraceLevel::Verbose`보다 크면 `E_INVALIDARG`를 반환하며, 이 경우 현재 추적 수준은 변경되지 않습니다.

## 설명

PlayFab 추적 영역에는 `PlayFabCore`, `PlayFabServices` 및 `PlayFabGameSave`가 기록하는 이벤트가 포함됩니다. `PlayFabCore`가 수준을 저장하며, 세 라이브러리 모두 이를 사용합니다. 기본 수준은 `PFTraceLevel::Verbose`입니다. 각 `PFTraceLevel` 값은 libHttpClient의 [HCTraceLevel](https://docs.xbox.com/ko/reference/live/httpclient/trace/enums/hctracelevel.md)에서 일치하는 값과 같습니다.

이 함수는 [PFInitialize](https://docs.xbox.com/ko/services/playfab/api-references/c/pfcore/functions/pfinitialize.md) 전을 포함하여 언제든지 호출할 수 있습니다. 수준은 원자적으로 저장되므로 모든 스레드에서 이 함수를 호출할 수 있습니다. 수준은 [PFUninitializeAsync](https://docs.xbox.com/ko/services/playfab/api-references/c/pfcore/functions/pfuninitializeasync.md) 후에도 계속 적용됩니다.

이 함수는 libHttpClient의 추적 수준을 변경하지 않습니다. libHttpClient의 HTTP 및 WebSocket 이벤트를 제어하려면 [HCSettingsSetTraceLevel](https://docs.xbox.com/ko/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md)을 호출하세요. PlayFab이 초기화된 후 이 필터를 통과하는 PlayFab 이벤트는 디버거([HCTraceSetTraceToDebugger](https://docs.xbox.com/ko/reference/live/httpclient/trace/functions/hctracesettracetodebugger.md)) 및 클라이언트 콜백([HCTraceSetClientCallback](https://docs.xbox.com/ko/reference/live/httpclient/trace/functions/hctracesetclientcallback.md))과 같이 libHttpClient 추적을 통해 구성한 출력으로 전달됩니다. 또한 `PFInitialize` 전에 [PFTraceEnableTraceToFile](https://docs.xbox.com/ko/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile.md) 호출이 성공했고 스토리지 처리기가 파일을 쓸 수 있는 경우 추적 파일로도 전달됩니다.

다음 예제에서는 모든 PlayFab 및 libHttpClient 추적 이벤트를 디버거로 보냅니다.

```cpp theme={null}
PFSettingsSetTraceLevel(PFTraceLevel::Verbose);
HCSettingsSetTraceLevel(HCTraceLevel::Verbose);
HCTraceSetTraceToDebugger(true);
```

## 요구 사항

**헤더:** PFTrace.h

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

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

## 참고 항목

[PFTrace 멤버](https://docs.xbox.com/ko/services/playfab/api-references/c/pftrace/pftrace_members.md)\
[디버그 추적](https://docs.xbox.com/ko/services/playfab/sdks/c/tracing.md)


## Related topics

- [Services C API 개요 - PFTrace.h](https://docs.xbox.com/ko/services/playfab/api-references/c/pftrace/pftrace_members.md)
- [디버그 추적](https://docs.xbox.com/ko/services/playfab/sdks/c/tracing.md)
- [PFTraceEnableTraceToFile](https://docs.xbox.com/ko/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile.md)
- [HCSettingsSetTraceLevel](https://docs.xbox.com/ko/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md)
- [HCSettingsGetTraceLevel](https://docs.xbox.com/ko/reference/live/httpclient/trace/functions/hcsettingsgettracelevel.md)