XblMultiplayerManagerJoinGame
Rejoint une session de jeu, en utilisant le nom de session globalement unique.Syntaxe
Paramètres
sessionName _In_z_Type : char* Le nom de session globalement unique de la session de jeu. sessionTemplateName _In_z_
Type : char* Le nom du modèle de session sur lequel la session de jeu doit être basée. xuids _In_opt_
Type : uint64_t* Tableau d’ID utilisateur XBOX (XUID) qui représente les utilisateurs que vous souhaitez intégrer au jeu. xuidsCount _In_
Type : size_t Le nombre d’éléments du tableau spécifié pour
xuids.
Valeur de retour
Type : HRESULT Code de retour HRESULT pour cette opération d’API.Remarques
Cette fonction fait rejoindre une liste d’utilisateurs XBOX, spécifiés dansxuids, à la session de jeu identifiée par le nom de session globalement unique spécifié dans sessionName. Vous pouvez obtenir le nom de session globalement unique à partir des résultats du matchmaking tiers du titre, et vous devez appeler cette fonction pour tous les clients qui doivent rejoindre le jeu. 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::JoinGameCompleted. Vous pouvez appeler XblMultiplayerManagerDoWork pour récupérer les événements multijoueurs. Lors d’une tentative de connexion à une session de jeu, le service renvoie
HTTP_E_STATUS_BAD_REQUEST si le serveur est plein. Après avoir rejoint la session, vous pouvez définir les propriétés de la session de jeu en appelant XblMultiplayerManagerGameSessionSetProperties ou XblMultiplayerManagerGameSessionSetSynchronizedProperties, ou vous pouvez définir l’hôte de la session de jeu en appelant XblMultiplayerManagerGameSessionSetSynchronizedHost.