> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XUserDeviceAssociationChange

> XUserDeviceAssociationChange

# XUserDeviceAssociationChange

Spécifie l'ancienne et la nouvelle association d'appareil lorsqu'une association d'appareil change.

## Syntaxe

```cpp theme={null}
typedef struct XUserDeviceAssociationChange {  
    APP_LOCAL_DEVICE_ID deviceId;  
    XUserLocalId oldUser;  
    XUserLocalId newUser;  
} XUserDeviceAssociationChange  
```

### Membres

*deviceId*\
Type : [APP\_LOCAL\_DEVICE\_ID](https://docs.xbox.com/fr/reference/system/xuser/structs/app_local_device_id.md)

L'ID de l'appareil dont l'association utilisateur change.

*oldUser*\
Type : [XUserLocalId](https://docs.xbox.com/fr/reference/system/xuser/structs/xuserlocalid.md)

L'ancien ID utilisateur associé à l'appareil.

*newUser*\
Type : [XUserLocalId](https://docs.xbox.com/fr/reference/system/xuser/structs/xuserlocalid.md)

Le nouvel ID utilisateur associé à l'appareil.

## Remarques

Tous les arguments de XUserDeviceAssociationChange peuvent être « null » :

* Si deviceId est égal à **XUserNullDeviceId**, la modification d'utilisateur s'applique à tous les appareils, tous les appareils étant associés à un utilisateur connecté.
* Si oldUser est égal à **XUserNullUserLocalId**, l'association appareil-utilisateur est nouvelle.
* Si newUser est égal à **XUserNullUserLocalId**, l'association appareil-utilisateur existante est perdue.

> [!NOTE]
>
> *newUser* ne peut référencer que des utilisateurs déjà ajoutés au titre via un appel à [XUserAddAsync](https://docs.xbox.com/fr/reference/system/xuser/functions/xuseraddasync.md). Si le sélecteur système a été utilisé pour associer un périphérique d'entrée à un utilisateur que le titre ne connaît pas, newUser sera égal à **XUserNullUserLocalId**. Pour plus d'informations, consultez [Utilisateurs et périphériques d'entrée](https://docs.xbox.com/fr/build/core-features/common/user/users-input-devices.md).

Ces membres doivent être traités comme une structure d'octets bruts pouvant être comparée à l'aide de memcmp ou d'une méthode équivalente. Par exemple :

```cpp theme={null}
XUserDeviceAssociationChange *change; // incoming argument from callback

if(memcmp(&change->deviceId, &XUserNullDeviceId, sizeof(APP_LOCAL_DEVICE_ID) == 0))
{
}

if(memcmp(&change->newUser, &XUserNullUserLocalId, sizeof(XUserLocalId) == 0))
{
}
```

La fonction de rappel [XUserDeviceAssociationChangedCallback](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md) utilise un pointeur vers une structure XUserDeviceAssociationChange.

La fonction de rappel passe le contexte à la fonction [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md) lors de l'inscription du rappel.

La fonction [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md) inscrit un rappel pour les événements de modification de l'association entre utilisateur et appareil.

## Configuration requise

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

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

## Voir aussi

[XUser](https://docs.xbox.com/fr/reference/system/xuser/xuser_members.md)

[XUserDeviceAssociationChangedCallback](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md)

[XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md)


## Related topics

- [XUserDeviceAssociationChangedCallback](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserdeviceassociationchangedcallback.md)
- [XUser (contenu de l'API)](https://docs.xbox.com/fr/reference/system/xuser/xuser_members.md)
- [APP_LOCAL_DEVICE_ID](https://docs.xbox.com/fr/reference/system/xuser/structs/app_local_device_id.md)
- [XUserUnregisterForDeviceAssociationChanged](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserunregisterfordeviceassociationchanged.md)
- [XUserRegisterForDeviceAssociationChanged](https://docs.xbox.com/fr/reference/system/xuser/functions/xuserregisterfordeviceassociationchanged.md)