> ## 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)。傳遞 `PFTraceLevel::Off` 可捨棄 PlayFab 追蹤區域中的所有追蹤事件。

### 傳回值

類型：HRESULT

如果已設定追蹤層級，則傳回 `S_OK`。如果 `traceLevel` 大於 `PFTraceLevel::Verbose`，則傳回 `E_INVALIDARG`；在此情況下，目前的追蹤層級不會變更。

## 備註

PlayFab 追蹤區域包含 `PlayFabCore`、`PlayFabServices` 和 `PlayFabGameSave` 所記錄的事件。`PlayFabCore` 會儲存層級，而這三個程式庫都會使用它。預設層級為 `PFTraceLevel::Verbose`。每個 `PFTraceLevel` 值都等於 libHttpClient 之 [HCTraceLevel](https://docs.xbox.com/zh-TW/reference/live/httpclient/trace/enums/hctracelevel.md) 的對應值。

您可以隨時呼叫此函式，包括在 [PFInitialize](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfcore/functions/pfinitialize.md) 之前。層級會以不可部分完成的方式儲存，因此您可以從任何執行緒呼叫此函式。層級在 [PFUninitializeAsync](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pfcore/functions/pfuninitializeasync.md) 之後仍然有效。

此函式不會變更 libHttpClient 的追蹤層級。若要控制 libHttpClient 的 HTTP 和 WebSocket 事件，請呼叫 [HCSettingsSetTraceLevel](https://docs.xbox.com/zh-TW/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md)。PlayFab 初始化之後，通過此篩選的 PlayFab 事件會送往您透過 libHttpClient 追蹤設定的輸出，例如偵錯工具 ([HCTraceSetTraceToDebugger](https://docs.xbox.com/zh-TW/reference/live/httpclient/trace/functions/hctracesettracetodebugger.md)) 和用戶端回呼 ([HCTraceSetClientCallback](https://docs.xbox.com/zh-TW/reference/live/httpclient/trace/functions/hctracesetclientcallback.md))。如果在 `PFInitialize` 之前呼叫 [PFTraceEnableTraceToFile](https://docs.xbox.com/zh-TW/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/zh-TW/services/playfab/api-references/c/pftrace/pftrace_members.md)\
[偵錯追蹤](https://docs.xbox.com/zh-TW/services/playfab/sdks/c/tracing.md)


## Related topics

- [Services C API overview - PFTrace.h](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pftrace/pftrace_members.md)
- [偵錯追蹤](https://docs.xbox.com/zh-TW/services/playfab/sdks/c/tracing.md)
- [PFTraceEnableTraceToFile](https://docs.xbox.com/zh-TW/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile.md)
- [HCSettingsSetTraceLevel](https://docs.xbox.com/zh-TW/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md)
- [HCSettingsGetTraceLevel](https://docs.xbox.com/zh-TW/reference/live/httpclient/trace/functions/hcsettingsgettracelevel.md)