> ## 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ÉCONSEILLÉ. Sera supprimé dans une version ultérieure *InitialTeam*\ Type : const char\* Affectation d'équipe initiale provenant de SmartMatch. *ArbitrationStatus*\ Type : [XblTournamentArbitrationStatus](/fr-CA/reference/live/xsapi-c/multiplayer_c/enums/xbltournamentarbitrationstatus) État d'arbitrage d'un membre dans un tournoi. DÉCONSEILLÉ. Sera supprimé dans une version ultérieure *Xuid*\ Type : uint64\_t ID d'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\* L'adresse d'appareil sécurisée du membre, encodée en base64. (Facultatif) *Roles*\ Type : const [XblMultiplayerSessionMemberRole\*](/fr-CA/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionmemberrole) Un 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] Le gamertag du membre. (Facultatif) Connu uniquement si le membre a accepté. *Status*\ Type : [XblMultiplayerSessionMemberStatus](/fr-CA/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionmemberstatus) L'état de ce membre. *IsTurnAvailable*\ Type : bool Est 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 s'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 jumelage ajoute un utilisateur à une session, il peut fournir du contexte sur la manière dont l'utilisateur a été jumelé à la session et pourquoi. Il s'agit d'une copie des serverMeasurements de l'utilisateur provenant de la session de jumelage. *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\* Une collection de memberIds de mon groupe. Si une liste « initializationGroup » est définie, l'index du membre lui-même y est toujours ajouté s'il n'est pas déjà présent. Pendant l'initialisation gérée, si un membre de la liste échoue, ce membre échoue également. *MembersInGroupCount*\ Type : size\_t Le 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-CA/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken) Défini lorsque le membre téléverse 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-CA/reference/live/xsapi-c/multiplayer_c/enums/xblnetworkaddresstranslationsetting) Il s'agit du paramètre NAT de l'appareil lorsque le membre téléverse 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 Il n'est utile de lire cette valeur 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, cette valeur est définie sur l'épisode d'initialisation auquel le membre participera; sinon, elle est 0. Les utilisateurs rejoignent les sessions par lots. Le numéro d'épisode d'initialisation indique un ensemble d'utilisateurs pour 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 au moment de sa création. *JoinTime*\ Type : time\_t L'heure à laquelle l'utilisateur a rejoint la session. Si « reserved » est true, il s'agit de l'heure à laquelle la réservation a été effectuée. *InitializationFailureCause*\ Type : [XblMultiplayerMeasurementFailure](/fr-CA/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayermeasurementfailure) La raison de l'échec de l'initialisation, ou XblMultiplayerMeasurementFailure::None s'il n'y a eu aucun échec. Défini lors de la sortie de l'étape « joining » ou « measuring » si ce membre ne réussit pas. *Groups*\ Type : const char\*\* Un tableau de noms de groupes pour l'utilisateur actuel indiquant les groupes dont cet utilisateur a fait partie pendant une session multijoueur. *GroupsCount*\ Type : size\_t Le 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 Le nombre d'éléments dans le tableau Groups. *TournamentTeamSessionReference*\ Type : [XblMultiplayerSessionReference](/fr-CA/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionreference) La référence de session d'équipe de tournoi. DÉCONSEILLÉ. Sera supprimé dans une version ultérieure *Internal*\ Type : void\* Usage interne uniquement. ## Configuration requise **En-tête :** multiplayer\_c.h ## Voir aussi [multiplayer\_c](/fr-CA/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)