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

# 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](/pt-BR/reference/errorcodes).
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</Note>
[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)](/pt-BR/home/setup-install/devkits/setup/activating-dev-kit)\
[XSystemGetXboxLiveSandbodId](/pt-BR/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid)\
[XSystem](/pt-BR/reference/system/xsystem/xsystem_members)


## Related topics

- [XSystemGetAppSpecificDeviceId](/ja-jp/reference/system/xsystem/functions/xsystemgetappspecificdeviceid.md)
- [XSystem](/reference/system/xsystem/xsystem_members.md)
- [XSystemGetConsoleId](/reference/system/xsystem/functions/xsystemgetconsoleid.md)