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

# XSystemGetConsoleId

> XSystemGetConsoleId

# XSystemGetConsoleId

Devuelve el identificador de consola del dispositivo actual.

## Sintaxis

```cpp theme={null}
HRESULT XSystemGetConsoleId(  
         size_t consoleIdSize,  
         char* consoleId,  
         size_t* consoleIdUsed  
)  
```

### Parámetros

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

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

*consoleId*   \_Out\_writes\_bytes\_to\_(consoleIdSize,\*consoleIdUsed)\
Tipo: char\*

El búfer de caracteres que recibirá el identificador de consola.

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

El tamaño, en bytes, del búfer *consoleId* 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 *consoleIdSize* está establecido en un valor menor que **XSystemConsoleIdBytes**, 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 [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

El identificador de consola identifica de forma única un dispositivo XBOX para XBOX Live solo en escenarios de desarrollo. El identificador de consola se usa para identificar la consola con fines de registro y administración; por ejemplo, para capturar información de análisis o para determinar qué kit de desarrollo reiniciar en un entorno de desarrollo. El identificador devuelto por esta función coincide con el identificador de consola visible en Settings \ System \ Console info.

Para los dispositivos XBOX, el identificador de consola se almacena en el dispositivo. Si no se encuentra el identificador de consola, o si no tiene permiso para acceder a él, el identificador de consola tiene como valor predeterminado `00000000.00000000.00000000.00000000.00`. Para los dispositivos PC, el identificador de consola siempre tiene como valor predeterminado `00000000.00000000.00000000.00000000.00`.

En RETAIL, esta función siempre devolverá `00000000.00000000.00000000.00000000.00`. Si el juego necesita un identificador que se pueda
usar en todas las situaciones, incluida la venta al público, hay dos posibilidades:

* 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.
* De lo contrario, use la función [XSystemGetAppSpecificDeviceId](/reference/system/xsystem/functions/xsystemgetappspecificdeviceid).

## Requisitos

**Encabezado:** XSystem.h

**Biblioteca:** xgameruntime.lib

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

## Documentación conceptual

* [Subprocesos sensibles al tiempo](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)

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


## Related topics

- [XSystemGetXboxLiveSandboxId](/es/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid.md)
- [XSystem](/es/reference/system/xsystem/xsystem_members.md)
- [IXtfConsoleControlClient::GetSystemTime](/es/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getsystemtime.md)
- [XSystemGetAppSpecificDeviceId](/es/reference/system/xsystem/functions/xsystemgetappspecificdeviceid.md)
- [XtfGetConsoleFieldValue](/es/reference/tools/xtf/xtfapi/functions/xtfgetconsolefieldvalue-xbox-microsoft-m.md)