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

# XblMultiplayerSessionMember

> XblMultiplayerSessionMember

# XblMultiplayerSessionMember

Représente une référence en lecture seule à un membre d'une session multijoueur.

## Syntaxe

```cpp theme={null}
typedef struct XblMultiplayerSessionMember {  
    uint32_t MemberId;  
    const char* TeamId;  
    const char* InitialTeam;  
    XblTournamentArbitrationStatus ArbitrationStatus;  
    uint64_t Xuid;  
    const char* CustomConstantsJson;  
    const char* SecureDeviceBaseAddress64;  
    const XblMultiplayerSessionMemberRole* Roles;  
    size_t RolesCount;  
    const char* CustomPropertiesJson;  
    char Gamertag[XBL_GAMERTAG_CHAR_SIZE];  
    XblMultiplayerSessionMemberStatus Status;  
    bool IsTurnAvailable;  
    bool IsCurrentUser;  
    bool InitializeRequested;  
    const char* MatchmakingResultServerMeasurementsJson;  
    const char* ServerMeasurementsJson;  
    const uint32_t* MembersInGroupIds;  
    size_t MembersInGroupCount;  
    const char* QosMeasurementsJson;  
    XblDeviceToken DeviceToken;  
    XblNetworkAddressTranslationSetting Nat;  
    uint32_t ActiveTitleId;  
    uint32_t InitializationEpisode;  
    time_t JoinTime;  
    XblMultiplayerMeasurementFailure InitializationFailureCause;  
    const char** Groups;  
    size_t GroupsCount;  
    const char** Encounters;  
    size_t EncountersCount;  
    XblMultiplayerSessionReference TournamentTeamSessionReference;  
    void* Internal;  
} XblMultiplayerSessionMember  
```

### Membres

*MemberId*\
Type : uint32\_t

ID de ce membre. Unique dans le contexte de la session dont ce membre fait partie.

*TeamId*\
Type : const char\*

ID de l'équipe de ce membre dans un tournoi. DÉPRÉCIÉ. Il sera supprimé dans une version ultérieure

*InitialTeam*\
Type : const char\*

Affectation d'équipe initiale de SmartMatch.

*ArbitrationStatus*\
Type : [XblTournamentArbitrationStatus](/fr/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus)

État d'arbitrage d'un membre dans un tournoi. DÉPRÉCIÉ. Il sera supprimé dans une version ultérieure

*Xuid*\
Type : uint64\_t

ID utilisateur XBOX du membre. Connu uniquement si le membre a accepté.

*CustomConstantsJson*\
Type : const char\*

Chaîne JSON qui spécifie les constantes personnalisées du membre.

*SecureDeviceBaseAddress64*\
Type : const char\*

Adresse d'appareil sécurisée du membre, encodée en base64. (Facultatif)

*Roles*\
Type : const [XblMultiplayerSessionMemberRole\*](/fr/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole)

Tableau de rôles pour ce membre. (Facultatif)

*RolesCount*\
Type : size\_t

Nombre d'entrées dans le tableau Roles.

*CustomPropertiesJson*\
Type : const char\*

Chaîne JSON qui spécifie les propriétés personnalisées du membre.

*Gamertag*\
Type : char\[XBL\_GAMERTAG\_CHAR\_SIZE]

Gamertag du membre. (Facultatif) Connu uniquement si le membre a accepté.

*Status*\
Type : [XblMultiplayerSessionMemberStatus](/fr/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionmemberstatus)

État de ce membre.

*IsTurnAvailable*\
Type : bool

A la valeur true uniquement si ce membre est prêt pour son tour.

*IsCurrentUser*\
Type : bool

Indique si ce MultiplayerSessionMember correspond à l'utilisateur actuel.

*InitializeRequested*\
Type : bool

Indique qu'il faut exécuter l'initialisation QoS pour cet utilisateur. La valeur par défaut est false. Ignoré s'il n'existe pas de section "memberInitialization" pour la session.

*MatchmakingResultServerMeasurementsJson*\
Type : const char\*

Lorsque le service de matchmaking ajoute un utilisateur à une session, il peut fournir du contexte sur la manière dont il a été associé à la session et la raison. Il s'agit d'une copie des serverMeasurements de l'utilisateur provenant de la session de matchmaking.

*ServerMeasurementsJson*\
Type : const char\*

Mesures QoS par chaîne de connexion de serveur de jeu. Comme tous les champs, "serverMeasurements" doit être mis à jour dans son ensemble ; il doit donc être défini une seule fois lorsque la mesure est terminée. S'il est vide, cela signifie qu'aucune des mesures ne s'est terminée dans le délai "serverMeasurementTimeout".

*MembersInGroupIds*\
Type : const uint32\_t\*

Collection de memberIds de mon groupe. Si une liste "initializationGroup" est définie, l'index du membre lui-même est toujours ajouté s'il n'est pas déjà présent. Pendant l'initialisation gérée, si l'un des membres de la liste échoue, ce membre échoue également.

*MembersInGroupCount*\
Type : size\_t

Nombre d'entrées dans le tableau MembersInGroupIds.

*QosMeasurementsJson*\
Type : const char\*

Mesures QoS par adresse d'appareil sécurisée. Comme tous les champs, "measurements" doit être mis à jour dans son ensemble. Il doit être défini une seule fois lorsque la mesure est terminée, et non de manière incrémentielle. Si un objet "measurements" est défini, il ne peut pas contenir d'entrée pour l'adresse du membre lui-même.

*DeviceToken*\
Type : [XblDeviceToken](/fr/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken)

Défini lorsque le membre charge une adresse d'appareil sécurisée. Il s'agit d'une chaîne qui ne respecte pas la casse et qui peut être utilisée pour les comparaisons d'égalité.

*Nat*\
Type : [XblNetworkAddressTranslationSetting](/fr/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting)

Paramètre NAT de l'appareil lorsque le membre charge une adresse d'appareil sécurisée.

*ActiveTitleId*\
Type : uint32\_t

Si le membre est actif, il s'agit de l'ID du titre dans lequel il est actif.

*InitializationEpisode*\
Type : uint32\_t

Cette valeur n'est utile à lire que lorsque le titre gère manuellement sa propre QoS. Si la section "memberInitialization" est définie et que le membre a été ajouté avec "initialize":true, elle correspond à l'épisode d'initialisation auquel le membre participera ; sinon, elle vaut 0. Les utilisateurs rejoignent les sessions par lots. Le numéro d'épisode d'initialisation indique un ensemble d'utilisateurs sur lesquels la QoS doit être effectuée. L'épisode d'initialisation 1 est une valeur spéciale utilisée pour les membres ajoutés à une nouvelle session lors de sa création.

*JoinTime*\
Type : time\_t

Heure à laquelle l'utilisateur a rejoint la session. Si "reserved" a la valeur true, il s'agit de l'heure à laquelle la réservation a été effectuée.

*InitializationFailureCause*\
Type : [XblMultiplayerMeasurementFailure](/fr/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure)

Cause de l'échec de l'initialisation, ou XblMultiplayerMeasurementFailure::None en l'absence d'échec. Défini lors de la sortie de l'étape "joining" ou "measuring" si ce membre ne la réussit pas.

*Groups*\
Type : const char\*\*

Tableau de noms de groupes pour l'utilisateur actuel, indiquant les groupes dont cet utilisateur faisait partie pendant une session multijoueur.

*GroupsCount*\
Type : size\_t

Nombre d'éléments dans le tableau Groups.

*Encounters*\
Type : const char\*\*

Obtient une liste de noms de groupes pour l'utilisateur actuel, indiquant les groupes que cet utilisateur a rencontrés pendant une session multijoueur.

*EncountersCount*\
Type : size\_t

Nombre d'éléments dans le tableau Groups.

*TournamentTeamSessionReference*\
Type : [XblMultiplayerSessionReference](/fr/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference)

Référence de session de l'équipe du tournoi. DÉPRÉCIÉ. Elle sera supprimée dans une version ultérieure

*Internal*\
Type : void\*

Usage interne uniquement.

## Configuration requise

**En-tête :** multiplayer\_c.h

## Voir aussi

[multiplayer\_c](/fr/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerSessionMembers](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionmembers.md)
- [XblMultiplayerSessionMember](/ja-jp/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmember.md)