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

# XSystemHandleTrack

> XSystemHandleTrack

# XSystemHandleTrack

Registra um retorno de chamada para rastrear eventos de tempo de vida de identificadores no Gaming Runtime.

## Sintaxe

```cpp theme={null}
HRESULT XSystemHandleTrack(
  XSystemHandleCallback callback,
  void * context
)
```

### Parâmetros

*callback*    \_In\_\
Tipo: [XSystemHandleCallback](/pt-BR/reference/system/xsystem/functions/xsystemhandlecallback)

Um retorno de chamada definido pelo usuário que será chamado na criação e destruição de identificadores. Para desabilitar o rastreamento
de identificadores, passe NULL para o retorno de chamada.

*context*    \_In\_opt\_\
Tipo: void \*

Contexto definido pelo usuário a ser passado para o retorno de chamada.

### Valor retornado

Tipo:  [HRESULT](https://learn.microsoft.com/openspecs/windows_protocols/ms-erref/0642cb2f-2075-4469-918c-4441e69c548a)

Retornará **S\_OK** se for bem-sucedido; caso contrário, retornará um código de erro. Para obter uma lista de códigos de erro, consulte
[Códigos de erro](/pt-BR/reference/errorcodes).

## Comentários

Os desenvolvedores de jogos precisam ter a capacidade de solucionar bugs que envolvem o uso incorreto de identificadores.
A maioria das APIs do GRTS utiliza identificadores que correspondem ao tempo de vida de objetos internos na nossa
implementação da plataforma. Os jogos frequentemente encontram problemas causados por desenvolvedores que, acidentalmente,
fornecem identificadores inválidos (NULL, liberados anteriormente etc.) a essas APIs, levando a falhas do título.
Os desenvolvedores também podem, inadvertidamente, vazar identificadores, levando ao uso excessivo de recursos. O objetivo da
API de rastreamento de identificadores é capacitar os desenvolvedores a diagnosticar e corrigir esses problemas.

A API tem dois componentes: ativo e passivo. Todos os identificadores criados pelo GRTS são continuamente
rastreados tanto em cenários de depuração quanto de varejo. Sempre que identificadores são passados para nossas APIs, a
plataforma executa uma validação para garantir que esses identificadores correspondam a objetos internos válidos. Se
um identificador inválido for detectado, a plataforma registrará o erro em log e invocará
[XErrorReport](/pt-BR/reference/system/xerror/functions/xerrorsetoptions) para notificar o desenvolvedor sobre o problema. A plataforma não
faz nenhum esforço adicional para suprimir o uso do identificador inválido e permite que o aplicativo falhe
como falharia antes desse recurso. Por fim, quaisquer vazamentos de identificadores no momento de
[XGameRuntimeUninitialize](/pt-BR/reference/system/xgameruntimeinit/functions/xgameruntimeuninitialize) também serão relatados por meio de
[XErrorReport](/pt-BR/reference/system/xerror/functions/xerrorsetoptions). Atualmente, o sistema de rastreamento de identificadores não permite o
rastreamento de identificadores externos ao GRTS.

## Requisitos

**Cabeçalho:** XSystem.h

**Biblioteca:** xgameruntime.lib

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Membros de XSystem](/pt-BR/reference/system/xsystem/xsystem_members)

[XSystemHandleCallback](/pt-BR/reference/system/xsystem/functions/xsystemhandlecallback)


## Related topics

- [XSystemHandleTrack](/reference/system/xsystem/functions/xsystemhandletrack.md)
- [XSystemHandleCallback](/reference/system/xsystem/functions/xsystemhandlecallback.md)