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

# XSystemGetAppSpecificDeviceId

> XSystemGetAppSpecificDeviceId

# XSystemGetAppSpecificDeviceId

Retorna um valor exclusivo do console que é específico para a ID de título do chamador.

## Sintaxe

```cpp theme={null}
HRESULT XSystemGetAppSpecificDeviceId(  
         size_t appSpecificDeviceIdSize,  
         char* appSpecificDeviceId,  
         size_t* appSpecificDeviceIdUsed  
)  
```

### Parâmetros

*appSpecificDeviceIdSize*   \_In\_\
Tipo: size\_t

O tamanho de *appSpecificDeviceId*, em bytes. Esse valor deve ser igual ou maior que a constante **XSystemAppSpecificDeviceIdBytes**
definida em XSystem.h.

*appSpecificDeviceId*   \_Out\_writes\_bytes\_to\_(appSpecificDeviceIdSize, \*appSpecificDeviceIdUsed)\
Tipo: char\*

O buffer de caracteres que receberá a ID de dispositivo específica do aplicativo.

*appSpecificDeviceIdUsed*   \_Out\_opt\_\
Tipo: size\_t\*

O tamanho, em bytes, do buffer *appSpecificDeviceIdUsed* retornado.

### 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](https://docs.xbox.com/pt-BR/reference/errorcodes.md).
Se a função falhar porque *appSpecificDeviceIdSize* está definido com um valor menor que **XSystemAppSpecificDeviceIdBytes**, o
valor retornado será definido como **HRESULT\_FROM\_WIN32(ERROR\_INSUFFICIENT\_BUFFER)**.

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

A cadeia de caracteres constante "00000000000000000000000000000000000000000000" será retornada nos casos em que o identificador de dispositivo
específico do aplicativo não puder ser obtido devido a um erro.

Se o seu aplicativo estiver usando Logon Único (SSO), você deverá usar a ID pairwise do token SSO do XSTS em vez da ID retornada
por esta função.

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

[Ativando seu kit de desenvolvimento (tópico sob NDA)](https://docs.xbox.com/pt-BR/home/setup-install/devkits/setup/activating-dev-kit.md)\
[XSystemGetXboxLiveSandbodId](https://docs.xbox.com/pt-BR/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid.md)\
[XSystem](https://docs.xbox.com/pt-BR/reference/system/xsystem/xsystem_members.md)


## Related topics

- [XSystem (conteúdo da API)](https://docs.xbox.com/pt-BR/reference/system/xsystem/xsystem_members.md)
- [XSystemGetConsoleId](https://docs.xbox.com/pt-BR/reference/system/xsystem/functions/xsystemgetconsoleid.md)
- [Usar wrappers C# para APIs do GDK no seu projeto do Unity](https://docs.xbox.com/pt-BR/build/gdk-and-engines/unity/unity-api-wrappers.md)
- [APP_LOCAL_DEVICE_ID](https://docs.xbox.com/pt-BR/reference/system/xuser/structs/app_local_device_id.md)
- [GetDeviceId](https://docs.xbox.com/pt-BR/reference/lighting/lamparray/interfaces/ilamparray/methods/ilamparray_getdeviceid.md)