> ## 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/reference/errorcodes).
Si la fonction échoue parce que *appSpecificDeviceIdSize* est défini sur une valeur inférieure à **XSystemAppSpecificDeviceIdBytes**, la
valeur de retour est **HRESULT\_FROM\_WIN32(ERROR\_INSUFFICIENT\_BUFFER)**.

## Remarques

<Note>Cette fonction ne peut pas être appelée en toute sécurité sur un thread à contrainte de temps. Pour plus d'informations, consultez</Note>
[Threads à contrainte de 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 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 kit de développement (rubrique sous NDA)](/fr/home/setup-install/devkits/setup/activating-dev-kit)\
[XSystemGetXboxLiveSandbodId](/fr/reference/system/xsystem/functions/xsystemgetxboxlivesandboxid)\
[XSystem](/fr/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)