> ## 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` が保持し、3 つのライブラリすべてがそれを使用します。既定のレベルは `PFTraceLevel::Verbose` です。各 `PFTraceLevel` の値は、libHttpClient の [HCTraceLevel](https://docs.xbox.com/ja-jp/reference/live/httpclient/trace/enums/hctracelevel.md) の対応する値と同じです。

この関数は、[PFInitialize](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfcore/functions/pfinitialize.md) の前を含め、いつでも呼び出すことができます。レベルはアトミックに格納されるため、この関数は任意のスレッドから呼び出すことができます。レベルは [PFUninitializeAsync](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pfcore/functions/pfuninitializeasync.md) の後も有効なままです。

この関数は libHttpClient のトレース レベルを変更しません。libHttpClient の HTTP および WebSocket のイベントを制御するには、[HCSettingsSetTraceLevel](https://docs.xbox.com/ja-jp/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md) を呼び出します。PlayFab の初期化後、このフィルターを通過した PlayFab のイベントは、デバッガー ([HCTraceSetTraceToDebugger](https://docs.xbox.com/ja-jp/reference/live/httpclient/trace/functions/hctracesettracetodebugger.md)) やクライアント コールバック ([HCTraceSetClientCallback](https://docs.xbox.com/ja-jp/reference/live/httpclient/trace/functions/hctracesetclientcallback.md)) など、libHttpClient のトレースで構成した出力先に送られます。また、`PFInitialize` の前に [PFTraceEnableTraceToFile](https://docs.xbox.com/ja-jp/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/ja-jp/services/playfab/api-references/c/pftrace/pftrace_members.md)\
[デバッグ トレース](https://docs.xbox.com/ja-jp/services/playfab/sdks/c/tracing.md)


## Related topics

- [Services C API overview - PFTrace.h](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pftrace/pftrace_members.md)
- [デバッグ トレース](https://docs.xbox.com/ja-jp/services/playfab/sdks/c/tracing.md)
- [PFTraceEnableTraceToFile](https://docs.xbox.com/ja-jp/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile.md)
- [HCSettingsSetTraceLevel](https://docs.xbox.com/ja-jp/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md)
- [HCSettingsGetTraceLevel](https://docs.xbox.com/ja-jp/reference/live/httpclient/trace/functions/hcsettingsgettracelevel.md)