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

Retorna o TitleID do jogo.

## Sintaxe

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

### Parâmetros

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

Um ponteiro para o TitleID do jogo.

### 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). Se o TitleID não estiver configurado pelo desenvolvedor do jogo no arquivo MicrosoftGame.config, o valor retornado será definido como **HRESULT\_FROM\_WIN32(ERROR\_NOT\_FOUND)**.

## Comentários

<Note>Não é seguro chamar esta função em um thread sensível ao tempo. Para obter mais informações, consulte [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

O TitleID identifica exclusivamente o seu jogo para os serviços XBOX Live. Ele é usado em todos os serviços XBOX Live para permitir que seus usuários acessem o conteúdo Live do seu jogo, como estatísticas de usuário e conquistas, e para habilitar a funcionalidade multijogador do Live. O TitleID é armazenado no arquivo de manifesto MicrosoftGame.config do seu jogo.

O exemplo a seguir gera uma URL para chamar um serviço REST de back-end usado pelo jogo. A função **XGameGetXBoxTitleId** é chamada para incluir o TitleID como parte da 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();  
}   
```

## Requisitos

**Cabeçalho:** XGame.h

**Biblioteca:** xgameruntime.lib

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

## Documentação conceitual

* [Threads sensíveis ao tempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

## Confira também

[MicrosoftGame.config](/pt-BR/build/core-features/common/game-config/MicrosoftGameConfig-toc)\
[XGame](/pt-BR/reference/system/xgame/xgame_members)\
[Configurando áreas restritas para desenvolvimento do XBOX Live](/pt-BR/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)
- [Getting started with packaging titles for XBOX consoles](/build/core-features/common/packaging/overviews/packaging-getting-started-for-console.md)
- [XSystemGetXboxLiveSandboxId](/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid.md)
- [Get started packaging PC titles with MSIXVC tools](/build/core-features/common/packaging/overviews/packaging-getting-started-for-PC.md)