Skip to main content

​
XSystemGetAppSpecificDeviceId

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

​
Syntaxe

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

Il n’est pas sécuritaire d’appeler cette fonction sur un thread sensible au temps. Pour plus d’informations, consultez
Threads sensibles au temps. 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)
XSystemGetXboxLiveSandbodId
XSystem
Last modified on October 6, 2026