Passer au contenu principal

XblMultiplayerWriteSessionResult

Obtient le résultat d’une opération XblMultiplayerWriteSessionAsync.

Syntaxe

Paramètres

async   _Inout_
Type : XAsyncBlock*
AsyncBlock pour cette opération. handle   _Out_
Type : XblMultiplayerSessionHandle*
Retourne un handle vers une nouvelle instance d’un objet de session multijoueur local. Le XblMultiplayerSessionHandle doit être libéré par l’appelant en appelant XblMultiplayerSessionCloseHandle. Utilisez les API XblMultiplayerSession* pour obtenir les données de session à partir du handle. Si l’objet de session mis à jour n’est pas nécessaire, le fait de transmettre nullptr entraîne le nettoyage immédiat du nouvel objet de session multijoueur.

Valeur de retour

Type : HRESULT Code de retour HRESULT pour cette opération d’API. Il s’agit d’un HRESULT d’échec en cas d’erreur réseau ou de code d’état HTTP d’échec, sauf s’il s’agit d’un code 412 (Precondition Failed). Un code 412 retourne une réussite, car le service retourne également le dernier état de la session; vous devez donc appeler XblMultiplayerSessionWriteStatus() pour obtenir l’état d’écriture et appeler les API XblMultiplayerSession* pour obtenir les données de session à partir du handle.

Remarques

Notez que si vous quittez une session dont vous êtes le dernier membre et que sessionEmptyTimeout est égal à 0, la session sera supprimée immédiatement. Appelez XblMultiplayerSessionWriteStatus() pour obtenir l’état d’écriture.

Configuration requise

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

Voir aussi

multiplayer_c
Dernière modification le 6 octobre 2026