Skip to main content

XblMatchmakingCreateMatchTicketAsync

Envoie une demande de matchmaking au serveur et renvoie le ticket de match avec un ID de ticket. Appelez XblMatchmakingCreateMatchTicketResult une fois l’opération terminée pour obtenir le résultat.

Syntaxe

Paramètres

xboxLiveContext   _In_
Type : XblContextHandle
Contexte XBOX Live de l’utilisateur local. ticketSessionReference   _In_
Type : XblMultiplayerSessionReference
Session multijoueur à utiliser pour le match. matchmakingServiceConfigurationId   _In_
Type : char*
ID de configuration de service pour le match. hopperName   _In_
Type : char*
Nom de la trémie (hopper). ticketTimeout   _In_
Type : uint64_t
Durée maximale d’attente pour que les joueurs rejoignent la session. preserveSession   _In_
Type : XblPreserveSessionMode
Indique si la session doit être conservée. ticketAttributesJson   _In_
Type : char*
Attributs de ticket pour la session. (Facultatif) asyncBlock   _In_
Type : XAsyncBlock*
AsyncBlock pour cette opération.

Valeur de retour

Type : HRESULT Code de retour HRESULT pour cette opération d’API.

Remarques

L’objet ticket de match contient des informations renvoyées par le serveur, telles que l’ID de ticket et le temps d’attente, ainsi que des copies des données spécifiées par le titre provenant de l’objet de données du ticket.

Appel REST

Appelle V103 POST /serviceconfigs//hoppers/

Configuration requise

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

Voir aussi

matchmaking_c
Last modified on October 6, 2026