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 les 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 tout conflit 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 les 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 retourne
HTTP_E_STATUS_PRECOND_FAILED. Si un conflit se produit, réévaluez la nécessité de modifier la propriété personnalisée et, au besoin, appelez de nouveau cette fonction pour soumettre à nouveau la demande. Le résultat de cette fonction est livré 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