XblMultiplayerManagerLobbySessionSetSynchronizedProperties
Définit la valeur d’une propriété personnalisée de la session de lobby, à l’aide deXblMultiplayerSessionWriteMode::SynchronizedUpdate.
Syntaxe
Paramètres
name _In_z_Type : char* Le nom de la propriété personnalisée à définir. valueJson _In_z_
Type : char* La valeur à affecter à la propriété, sous forme de chaîne JSON. context _In_opt_
Type : void* Facultatif. Les données définies par l’application permettant de corréler l’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 lobby. Les propriétés personnalisées peuvent être modifiées à tout moment. Si les propriétés personnalisées sont partagées entre plusieurs appareils, ou peuvent être mises à jour par plusieurs appareils en même temps, utilisez cette fonction pour garantir l’atomicité et résoudre les conflits éventuels entre les appareils lors de la modification des valeurs de ces propriétés personnalisées. Si une propriété personnalisée n’est pas partagée entre plusieurs appareils, utilisez plutôt la fonction XblMultiplayerManagerLobbySessionSetProperties pour modifier la valeur de cette propriété personnalisée.Le service peut rejeter la demande de modification de la propriété personnalisée si une condition de concurrence se produit en raison d’un conflit. Si la demande est rejetée, le service renvoie
HTTP_E_STATUS_PRECOND_FAILED. En cas de conflit, réévaluez la nécessité de modifier la propriété personnalisée et, si nécessaire, appelez de nouveau cette fonction pour soumettre à nouveau la demande. Le résultat de cette fonction est remis sous la forme d’un événement multijoueur dont le type d’événement est défini sur
XblMultiplayerEventType::SessionSynchronizedPropertyWriteCompleted. Vous pouvez appeler XblMultiplayerManagerDoWork pour récupérer les événements multijoueurs.
Configuration requise
En-tête : multiplayer_manager_c.h Bibliothèque : Microsoft.Xbox.Services.14x.GDK.C.libVoir aussi
multiplayer_manager_cXblMultiplayerManagerLobbySessionSetSynchronizedHost
XblMultiplayerEvent