Skip to main content

XblMultiplayerManagerGameSessionSetSynchronizedHost

Définit l’hôte de la session de jeu, en utilisant XblMultiplayerSessionWriteMode::SynchronizedUpdate.

Syntaxe

Paramètres

deviceToken   _In_
Type : char*
Le jeton d’appareil de l’hôte. 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 l’hôte de la session de jeu. Utilisez cette fonction pour garantir l’atomicité et résoudre tout conflit entre des appareils qui tentent de définir l’hôte en même temps.
Le service peut rejeter la demande de définition de l’hôte 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 changer l’hôte 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::SynchronizedHostWriteCompleted. Vous pouvez appeler XblMultiplayerManagerDoWork pour récupérer les événements multijoueurs. Notez que les jetons d’appareil de l’hôte sont générés à partir de l’adresse d’appareil sécurisée d’un membre de la session; assurez-vous donc que l’adresse d’appareil sécurisée est définie pour l’hôte souhaité avant d’appeler cette méthode.

Configuration requise

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

Voir aussi

multiplayer_manager_c
XblMultiplayerManagerGameSessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress
Last modified on October 6, 2026