Skip to main content

XblMultiplayerManagerLobbySessionSetProperties

Définit la valeur d’une propriété personnalisée de la session de salon.

Syntaxe

Paramètres

name   _In_z_
Type : char*
Nom de la propriété personnalisée à définir. valueJson   _In_z_
Type : char*
Valeur à attribuer à la propriété, sous forme de chaîne JSON. context   _In_opt_
Type : void*
Facultatif. Données définies par l’application permettant de corréler l’événement XblMultiplayerEvent à l’appel initial.

Valeur de retour

Type : HRESULT Code de retour HRESULT pour cette opération d’API.

Remarques

Cette fonction définit la valeur, représentée sous forme de chaîne JSON, d’une propriété personnalisée de la session de salon. Les propriétés personnalisées peuvent être modifiées à tout moment. Les modifications sont regroupées et écrites dans le service lors de l’appel à XblMultiplayerManagerDoWork. Si des propriétés personnalisées sont partagées entre plusieurs appareils ou peuvent être mises à jour par plusieurs appareils en même temps, utilisez la fonction XblMultiplayerManagerLobbySessionSetSynchronizedProperties pour modifier les propriétés personnalisées. Sinon, vous pouvez utiliser cette fonction pour modifier les propriétés personnalisées.
Le résultat de cette fonction est remis sous forme d’événement multijoueur dont le type d’événement est XblMultiplayerEventType::SessionPropertyWriteCompleted. Vous pouvez appeler XblMultiplayerManagerDoWork pour récupérer les événements multijoueur.

Configuration requise

En-tête : multiplayer_manager_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.lib

Voir aussi

multiplayer_manager_c
XblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent
Last modified on October 6, 2026