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

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\*\*

Collection de mots clés associés à la session (facultatif, peut être vide).

*KeywordCount*\
Type : size\_t

Nombre de mots clés.

*JoinRestriction*\
Type : [XblMultiplayerSessionRestriction](/fr/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 que cela n'a aucun impact sur les sessions "private" et "visible".) La valeur par défaut est "none". Si "local", seuls les utilisateurs dont le DeviceId du jeton correspond à celui d'une autre personne déjà présente dans la session avec "active": true. Si "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/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 que cela n'a aucun impact sur les sessions "private" et "visible".) La valeur par défaut est "none". Si "local", seuls les utilisateurs dont le DeviceId du jeton correspond à celui d'une autre personne déjà présente dans la session avec "active": true. Si "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 d'accès ; autrement dit, 'joinRestriction' ne peut pas être défini sur "followed" sans définir également 'readRestriction'."

*TurnCollection*\
Type : uint32\_t\*

Collection de MemberIds de session indiquant à qui c'est le tour.

*TurnCollectionCount*\
Type : size\_t

Nombre d'entrées dans le tableau TurnCollection.

*MatchmakingTargetSessionConstantsJson*\
Type : const char\*

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. En cas de 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\*\*

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 peuvent utiliser un mécanisme personnalisé pour choisir l'une des autres (par exemple en fonction de la charge).

*ServerConnectionStringCandidatesCount*\
Type : size\_t

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

Nombre d'entrées dans le tableau SessionOwnerMemberIds.

*HostDeviceToken*\
Type : [XblDeviceToken](/fr/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 considère que l'hôte indiqué est le bon et ne mesure les métriques que vers cet hôte.

*Closed*\
Type : bool

Détermine si une session peut être rejointe, indépendamment de la visibilité, de la restriction d'accès 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, les membres de la session peuvent être verrouillés, de sorte qu'un utilisateur qui quitte la session peut y revenir, mais qu'aucun autre utilisateur ne peut prendre sa place. La valeur par défaut est false.

*AllocateCloudCompute*\
Type : bool

La définition 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 correspondance trouvée n'a pas fonctionné et doit être soumise à nouveau. Définissez sur false pour signaler que la correspondance a fonctionné et que le service de matchmaking peut libérer la session.

## Configuration requise

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

## Voir aussi

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


## Related topics

- [Rubriques avancées sur les sessions multijoueurs](/fr/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)
- [Vue d'ensemble de Multiplayer Session Directory](/fr/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [XblMultiplayerSessionSessionProperties](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionsessionproperties.md)
- [XblMultiplayerSessionPropertiesSetKeywords](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionpropertiessetkeywords.md)
- [XblMultiplayerSessionDeleteCustomPropertyJson](/fr/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessiondeletecustompropertyjson.md)