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* Un tableau d’identifiants d’utilisateur XBOX (XUID) qui représente les utilisateurs que vous souhaitez inclure dans la partie. 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 joint 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 de la mise en relation tierce du titre, et vous devez appeler cette fonction pour tous les clients qui doivent rejoindre la partie. 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::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 retourne
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.