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

Retourne une valeur unique de la console propre à l'ID de titre de l'appelant.

## Syntaxe

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

### Paramètres

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

Taille de *appSpecificDeviceId*, en octets. Cette valeur doit être supérieure ou égale à la constante **XSystemAppSpecificDeviceIdBytes**
définie dans XSystem.h.

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

Mémoire tampon de caractères qui recevra l'ID d'appareil propre à l'application.

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

Taille, en octets, de la mémoire tampon *appSpecificDeviceIdUsed* retournée.

### Valeur de retour

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

Retourne **S\_OK** en cas de réussite; sinon, retourne un code d'erreur. Pour obtenir la liste des codes d'erreur, consultez [Codes d'erreur](/fr-CA/reference/errorcodes).
Si la fonction échoue parce que *appSpecificDeviceIdSize* est défini sur une valeur inférieure à **XSystemAppSpecificDeviceIdBytes**, la
valeur de retour est définie sur **HRESULT\_FROM\_WIN32(ERROR\_INSUFFICIENT\_BUFFER)**.

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread sensible au temps. Pour plus d'informations, consultez</Note>
[Threads sensibles au temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).

La chaîne constante "00000000000000000000000000000000000000000000" est retournée lorsque l'identificateur d'appareil
propre à l'application n'a pas pu être obtenu en raison d'une erreur.

Si votre application utilise l'authentification unique (SSO), vous devez utiliser l'ID par paire (pairwise ID) du jeton SSO XSTS au lieu de l'ID retourné
par cette fonction.

## Configuration requise

**En-tête :** XSystem.h

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Activation de votre trousse de développement (rubrique sous NDA)](/fr-CA/home/setup-install/devkits/setup/activating-dev-kit)\
[XSystemGetXboxLiveSandbodId](/fr-CA/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid)\
[XSystem](/fr-CA/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)