> ## 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. # XblMultiplayerSessionProperties > XblMultiplayerSessionProperties # XblMultiplayerSessionProperties Un ensemble de propriétés associées à cette session. N'importe quel joueur peut modifier ces propriétés. ## Syntaxe ```cpp theme={null} typedef struct XblMultiplayerSessionProperties { const char** Keywords; size_t KeywordCount; XblMultiplayerSessionRestriction JoinRestriction; XblMultiplayerSessionRestriction ReadRestriction; uint32_t* TurnCollection; size_t TurnCollectionCount; const char* MatchmakingTargetSessionConstantsJson; const char* SessionCustomPropertiesJson; const char* MatchmakingServerConnectionString; const char** ServerConnectionStringCandidates; size_t ServerConnectionStringCandidatesCount; uint32_t* SessionOwnerMemberIds; size_t SessionOwnerMemberIdsCount; XblDeviceToken HostDeviceToken; bool Closed; bool Locked; bool AllocateCloudCompute; bool MatchmakingResubmit; } XblMultiplayerSessionProperties ``` ### Membres *Keywords*\ Type : const char\*\* Une collection de mots clés associés à la session (facultatif, peut être vide). *KeywordCount*\ Type : size\_t Le nombre de mots clés. *JoinRestriction*\ Type : [XblMultiplayerSessionRestriction](/fr-CA/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionrestriction) Limite les utilisateurs qui peuvent rejoindre les sessions « open ». (N'a aucun effet sur les réservations, ce qui signifie qu'il n'a aucune incidence sur les sessions « private » et « visible ».) La valeur par défaut est « none ». Si la valeur est « local », seuls les utilisateurs dont le DeviceId du jeton correspond à celui d'une autre personne déjà dans la session avec "active": true. Si la valeur est « followed », seuls les utilisateurs locaux (tels que définis ci-dessus) et les utilisateurs suivis par un membre existant (non réservé) de la session peuvent la rejoindre sans réservation. *ReadRestriction*\ Type : [XblMultiplayerSessionRestriction](/fr-CA/reference/live/xsapi-c/multiplayer_c/enums/xblmultiplayersessionrestriction) Limite les utilisateurs qui peuvent lire les sessions « open ». (N'a aucun effet sur les réservations, ce qui signifie qu'il n'a aucune incidence sur les sessions « private » et « visible ».) La valeur par défaut est « none ». Si la valeur est « local », seuls les utilisateurs dont le DeviceId du jeton correspond à celui d'une autre personne déjà dans la session avec "active": true. Si la valeur est « followed », seuls les utilisateurs locaux (tels que définis ci-dessus) et les utilisateurs suivis par un membre existant (non réservé) de la session peuvent la lire sans réservation. La restriction de lecture s'applique aux sessions dont la visibilité est « open » ou « visible » et détermine qui peut lire la session sans invitation. La restriction de lecture doit être au moins aussi permissive que la restriction de participation, c.-à-d. que 'joinRestriction' ne peut pas être défini sur « followed » sans que 'readRestriction' soit également défini. *TurnCollection*\ Type : uint32\_t\* Une collection de MemberIds de session indiquant à qui c'est le tour. *TurnCollectionCount*\ Type : size\_t Le nombre d'entrées dans le tableau TurnCollection. *MatchmakingTargetSessionConstantsJson*\ Type : const char\* Une chaîne JSON représentant les constantes de la session cible. *SessionCustomPropertiesJson*\ Type : const char\* Chaîne JSON qui spécifie les propriétés personnalisées de la session. Celles-ci peuvent être modifiées à tout moment. Lors d'une modification, appelez multiplayer\_service::write\_session pour écrire les modifications dans le service. *MatchmakingServerConnectionString*\ Type : const char\* Force l'utilisation d'une chaîne de connexion spécifique. Utile dans les scénarios où l'on rejoint une session en cours. *ServerConnectionStringCandidates*\ Type : const char\*\* La liste ordonnée des chaînes de connexion que la session pourrait utiliser pour se connecter à un serveur de jeu. En général, les titres doivent utiliser la première de la liste, mais des titres plus élaborés pourraient utiliser un mécanisme personnalisé pour en choisir une autre (par exemple, en fonction de la charge). *ServerConnectionStringCandidatesCount*\ Type : size\_t Le nombre d'entrées dans le tableau ServerConnectionStringCandidates. *SessionOwnerMemberIds*\ Type : uint32\_t\* MemberIds de session des propriétaires de la session. *SessionOwnerMemberIdsCount*\ Type : size\_t Le nombre d'entrées dans le tableau SessionOwnerMemberIds. *HostDeviceToken*\ Type : [XblDeviceToken](/fr-CA/reference/live/xsapi-c/multiplayer_c/structs/xbldevicetoken) Jeton d'appareil de l'hôte. Doit correspondre au « deviceToken » d'au moins un membre, sinon ce champ est supprimé. Si « peerToHostRequirements » et « host » sont définis, l'étape de mesure suppose que l'hôte indiqué est le bon hôte et ne mesure que les métriques vers cet hôte. *Closed*\ Type : bool Détermine si une session peut être rejointe, indépendamment de la visibilité, de la restriction de participation et de l'espace disponible dans la session. N'affecte pas les réservations. La valeur par défaut est false. *Locked*\ Type : bool Si la valeur est true, permet de verrouiller les membres de la session, de sorte qu'un utilisateur qui quitte la session puisse y revenir, mais qu'aucun autre utilisateur ne puisse prendre sa place. La valeur par défaut est false. *AllocateCloudCompute*\ Type : bool La définition de cette valeur sur true par un client déclenche une tentative d'allocation XBOX Live Compute par MPSD. La valeur par défaut est false. *MatchmakingResubmit*\ Type : bool True si la partie trouvée n'a pas fonctionné et doit être soumise de nouveau. Définissez sur false pour signaler que la partie a fonctionné et que le service de jumelage peut libérer la session. ## 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 - [Rubriques avancées sur les sessions multijoueurs](/fr-CA/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md) - [Vue d'ensemble de Multiplayer Session Directory](/fr-CA/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md) - [XblMultiplayerSessionSessionProperties](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionproperties.md) - [XblMultiplayerSessionPropertiesSetKeywords](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionpropertiessetkeywords.md) - [XblMultiplayerSessionPropertiesSetJoinRestriction](/fr-CA/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionpropertiessetjoinrestriction.md)