XblMultiplayerManagerGameSessionSetSynchronizedProperties
Définit la valeur d’une propriété personnalisée pour la session de jeu, en utilisantXblMultiplayerSessionWriteMode::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 à attribuer à 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 le XblMultiplayerEvent à l’appel initiateur.
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 pour la session de jeu. Les propriétés personnalisées peuvent être modifiées à tout moment. Si des propriétés personnalisées sont partagées entre des 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 entre 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 des appareils, utilisez plutôt la fonction XblMultiplayerManagerGameSessionSetProperties 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 à nouveau cette fonction pour soumettre de nouveau la demande. Le résultat de cette fonction est transmis sous forme d’é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_cXblMultiplayerManagerGameSessionSetSynchronizedHost
XblMultiplayerEvent