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

> Define o nível mais detalhado dos eventos de rastreamento que PlayFabCore, PlayFabServices e PlayFabGameSave emitem na área de rastreamento do PlayFab.

Define o nível de rastreamento para eventos na área de rastreamento do Microsoft Azure PlayFab.

## Sintaxe

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

### Parâmetros

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

O nível máximo de detalhamento a ser emitido. Os eventos nesse nível e em níveis menos detalhados são emitidos, e os eventos mais detalhados são descartados. Em ordem do menos para o mais detalhado, os valores de `PFTraceLevel` são `Off` (0), `Error` (1), `Warning` (2), `Important` (3), `Information` (4) e `Verbose` (5). Passe `PFTraceLevel::Off` para descartar todos os eventos de rastreamento na área de rastreamento do PlayFab.

### Valor de retorno

Tipo: HRESULT

`S_OK` se o nível de rastreamento for definido. `E_INVALIDARG` se `traceLevel` for maior que `PFTraceLevel::Verbose`; nesse caso, o nível de rastreamento atual não é alterado.

## Comentários

A área de rastreamento do PlayFab contém os eventos que `PlayFabCore`, `PlayFabServices` e `PlayFabGameSave` registram em log. `PlayFabCore` armazena o nível, e as três bibliotecas o usam. O nível padrão é `PFTraceLevel::Verbose`. Cada valor de `PFTraceLevel` é igual ao valor correspondente de [HCTraceLevel](https://docs.xbox.com/pt-BR/reference/live/httpclient/trace/enums/hctracelevel.md) da libHttpClient.

Você pode chamar esta função a qualquer momento, inclusive antes de [PFInitialize](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfcore/functions/pfinitialize.md). O nível é armazenado atomicamente, portanto, você pode chamar esta função de qualquer thread. O nível permanece em vigor após [PFUninitializeAsync](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pfcore/functions/pfuninitializeasync.md).

Esta função não altera o nível de rastreamento da libHttpClient. Para controlar os eventos HTTP e WebSocket da libHttpClient, chame [HCSettingsSetTraceLevel](https://docs.xbox.com/pt-BR/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md). Depois que o PlayFab é inicializado, os eventos do PlayFab que passam por esse filtro vão para as saídas que você configura por meio do rastreamento da libHttpClient, como o depurador ([HCTraceSetTraceToDebugger](https://docs.xbox.com/pt-BR/reference/live/httpclient/trace/functions/hctracesettracetodebugger.md)) e os retornos de chamada do cliente ([HCTraceSetClientCallback](https://docs.xbox.com/pt-BR/reference/live/httpclient/trace/functions/hctracesetclientcallback.md)). Eles também vão para o arquivo de rastreamento se uma chamada a [PFTraceEnableTraceToFile](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile.md) antes de `PFInitialize` tiver sido bem-sucedida e os manipuladores de armazenamento puderem gravar o arquivo.

O exemplo a seguir envia todos os eventos de rastreamento do PlayFab e da libHttpClient para o depurador.

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

## Requisitos

**Cabeçalho:** PFTrace.h

**Biblioteca:** PlayFabCore.lib

**Plataformas compatíveis:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Membros de PFTrace](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pftrace/pftrace_members.md)\
[Rastreamento de depuração](https://docs.xbox.com/pt-BR/services/playfab/sdks/c/tracing.md)


## Related topics

- [Visão geral da API C de serviços - PFTrace.h](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pftrace/pftrace_members.md)
- [Rastreamento de depuração](https://docs.xbox.com/pt-BR/services/playfab/sdks/c/tracing.md)
- [PFTraceEnableTraceToFile](https://docs.xbox.com/pt-BR/services/playfab/api-references/c/pftrace/functions/pftraceenabletracetofile.md)
- [HCSettingsSetTraceLevel](https://docs.xbox.com/pt-BR/reference/live/httpclient/trace/functions/hcsettingssettracelevel.md)
- [HCSettingsGetTraceLevel](https://docs.xbox.com/pt-BR/reference/live/httpclient/trace/functions/hcsettingsgettracelevel.md)