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

# XGameGetXboxTitleId

> XGameGetXboxTitleId

# XGameGetXboxTitleId

Retourne le TitleID du jeu.

## Syntaxe

```cpp theme={null}
HRESULT XGameGetXboxTitleId(  
         uint32_t* titleId  
)  
```

### Paramètres

*titleId*   \_Out\_\
Type : uint32\_t\*

Pointeur vers le TitleID du jeu.

### Valeur de retour

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

Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes). Si le TitleID n'est pas configuré par le développeur du jeu dans le fichier MicrosoftGame.config, la valeur de retour est **HRESULT\_FROM\_WIN32(ERROR\_NOT\_FOUND)**.

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread urgent. Pour plus d'informations, consultez [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Le TitleID identifie de façon unique votre jeu auprès des services XBOX Live. Il est utilisé dans l'ensemble des services XBOX Live pour permettre à vos utilisateurs d'accéder au contenu Live de votre jeu, comme les statistiques des utilisateurs et les succès, et pour activer les fonctionnalités multijoueurs Live. Le TitleID est stocké dans le fichier manifeste MicrosoftGame.config de votre jeu.

L'exemple suivant génère une URL pour appeler un service REST principal utilisé par le jeu. La fonction **XGameGetXBoxTitleId** est appelée pour inclure le TitleID dans l'URL.

```cpp theme={null}
std::string GetBackendServiceUrl()  
{  
    uint32_t titleId;  
  
    RetailAssert(SUCCEEDED(XGameGetXboxTitleId(&titleId)));  
  
    std::stringstream url;  
    url << "https://example.com/some/api/call";  
  
    url << std::hex << std::uppercase << std::setfill('0');  
    url << "/titleId/" << std::setw(8) << titleId;  
  
    return url.str();  
}   
```

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

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

## Documentation conceptuelle

* [Threads urgents](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Voir aussi

[MicrosoftGame.config](/fr-CA/build/core-features/common/game-config/MicrosoftGameConfig-toc)\
[XGame](/fr-CA/reference/system/xgame/xgame_members)\
[Configuration des bacs à sable pour le développement XBOX Live](/fr-CA/services/xbox-services/fundamentals/sandboxes/live-setting-up-sandboxes)


## Related topics

- [XGameGetXboxTitleId](/reference/system/xgame/functions/xgamegetxboxtitleid.md)
- [XGame](/reference/system/xgame/xgame_members.md)