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

Devuelve un valor único de la consola que es específico del identificador de título del autor de la llamada.

## Sintaxis

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

### Parámetros

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

El tamaño de *appSpecificDeviceId*, en bytes. Este valor debe ser igual o mayor que la constante **XSystemAppSpecificDeviceIdBytes**
definida en XSystem.h.

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

El búfer de caracteres que recibirá el identificador de dispositivo específico de la aplicación.

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

El tamaño, en bytes, del búfer *appSpecificDeviceIdUsed* devuelto.

### Valor devuelto

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

Devuelve **S\_OK** si se realiza correctamente; de lo contrario, devuelve un código de error. Para obtener una lista de códigos de error, consulte [Códigos de error](/reference/errorcodes).
Si la función falla porque *appSpecificDeviceIdSize* está establecido en un valor menor que **XSystemAppSpecificDeviceIdBytes**, el
valor devuelto se establece en **HRESULT\_FROM\_WIN32(ERROR\_INSUFFICIENT\_BUFFER)**.

## Comentarios

<Note>No es seguro llamar a esta función en un subproceso sensible al tiempo. Para obtener más información, consulte</Note>
[Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

La cadena constante "00000000000000000000000000000000000000000000" se devolverá en los casos en que el identificador de dispositivo
específico de la aplicación no se haya podido obtener debido a un error.

Si su aplicación usa el inicio de sesión único (SSO), debe usar el identificador por pares del token SSO de XSTS en lugar del identificador devuelto
por esta función.

## Requisitos

**Encabezado:** XSystem.h

**Biblioteca:** xgameruntime.lib

**Plataformas compatibles:** Windows, consolas de la familia XBOX One y consolas XBOX Series

## Consulte también

[Activación del kit de desarrollo (tema con NDA)](/home/setup-install/devkits/setup/activating-dev-kit)\
[XSystemGetXboxLiveSandbodId](/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid)\
[XSystem](/reference/system/xsystem/xsystem_members)