Skip to main content

XblMultiplayerManagerLobbySessionSetSynchronizedHost

Définit l’hôte de la session de salon, à l’aide de XblMultiplayerSessionWriteMode::SynchronizedUpdate.

Syntaxe

Paramètres

deviceToken   _In_
Type : char*
Jeton d’appareil de l’hôte. 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 l’hôte de la session de salon. Utilisez cette fonction pour garantir l’atomicité et résoudre les conflits 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. En cas de conflit, réévaluez la nécessité de changer d’hôte et, au besoin, appelez de nouveau cette fonction pour soumettre à nouveau la demande.
Le résultat de cette fonction est remis sous forme d’événement multijoueur dont le type d’événement est XblMultiplayerEventType::SynchronizedHostWriteCompleted. Vous pouvez appeler XblMultiplayerManagerDoWork pour récupérer les événements multijoueur. 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
XblMultiplayerManagerLobbySessionSetSynchronizedProperties
XblMultiplayerEvent
XblMultiplayerManagerLobbySessionSetLocalMemberConnectionAddress
Last modified on October 6, 2026