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

# XErrorCallback

> XErrorCallback

# XErrorCallback

Rappel appelé si une erreur se produit dans le système d'exploitation de jeu ou le runtime de jeu.

## Syntaxe

```cpp theme={null}
bool XErrorCallback(  
         HRESULT hr,  
         const char* msg,  
         void* context  
)  
```

### Paramètres

*hr*   \_In\_\
Type : HRESULT

Code HRESULT associé à l'erreur.

*msg*   \_In\_z\_\
Type : char\*

Description textuelle de l'erreur.

*context*   \_In\_\
Type : void\*

Pointeur de contexte pour le rappel.

### Valeur de retour

Type : bool

Retournez `true` pour indiquer que le système doit continuer et effectuer l'action spécifiée par [XErrorSetOptions](/fr/reference/system/xerror/functions/xerrorsetoptions) ; sinon, retournez `false` pour ignorer l'erreur.

## Remarques

Utilisez la fonction [XErrorSetCallback](/fr/reference/system/xerror/functions/xerrorsetcallback) pour spécifier le rappel `XErrorCallback` de votre jeu que le système doit appeler si une erreur se produit, et la fonction `XErrorSetOptions` pour spécifier le comportement du jeu lorsqu'une erreur se produit dans le système d'exploitation de jeu ou le runtime de jeu.

L'exemple suivant montre comment définir les options d'erreur, définir un rappel d'erreur personnalisé et configurer ce rappel d'erreur personnalisé pour recevoir les notifications d'erreur du système.

```cpp theme={null}
bool CustomGameXErrorCallback(_In_ HRESULT hr, _In_ const char* msg, _In_ void* context)  
{  
   // Capture the error to the game's custom logger  
   CustomGameLogger* logger = (CustomGameLogger*)context;  
   logger->ReportGameRuntimeIssue(hr, msg);  
  
   // Don't ignore the error. For example, continue on and do whatever  
   // is specified by XErrorSetOptions().  
   return true;  
}  
  
void SomeGameFunction()  
{  
   // Previously initialize the game's custom logger  
   // CustomGameLogger* m_logger = InitializeLogger();  
   // ...  
  
   // Setup how you want to handle XErrors  
   XErrorSetOptions(DebugBreakOnError, FailFastOnError);
   XErrorSetCallback(CustomGameXErrorCallback, m_logger);
}  
```

## Configuration requise

**En-tête :** XError.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Membres de XError](/fr/reference/system/xerror/xerror_members)\
[XErrorSetCallback](/fr/reference/system/xerror/functions/xerrorsetcallback)


## Related topics

- [XErrorCallback](/reference/system/xerror/functions/xerrorcallback.md)
- [XErrorSetCallback](/reference/system/xerror/functions/xerrorsetcallback.md)