XblMultiplayerWriteSessionAsync

2025-04-28

Writes a new or updated multiplayer session to the service. The session must have a valid session reference. If it was not created with one, use XblMultiplayerWriteSessionByHandleAsync instead.

Syntax

HRESULT XblMultiplayerWriteSessionAsync(  
         XblContextHandle xblContext,  
         XblMultiplayerSessionHandle multiplayerSession,  
         XblMultiplayerSessionWriteMode writeMode,  
         XAsyncBlock* async  
)

Parameters

xblContext _In_
Type: XblContextHandle

Xbox live context for the local user.

multiplayerSession _In_
Type: XblMultiplayerSessionHandle

A MultiplayerSession object that has been modified with the changes to write.

writeMode _In_
Type: XblMultiplayerSessionWriteMode

The type of write operation.

async _Inout_
Type: XAsyncBlock*

The AsyncBlock for this operation.

Return value

Type: HRESULT

HRESULT return code for this API operation.

Remarks

In the async callback, call XblMultiplayerWriteSessionResult() to get a XblMultiplayerSessionHandle handle. Use that handle to call XblMultiplayerSessionWriteStatus() to get the write status. The call to XblMultiplayerWriteSessionAsync() will only fail if the args passed to it are invalid or in very rare cases where it could not start the async task.

REST Call

Calls V105 PUT /serviceconfigs/{serviceConfigurationId}/sessionTemplates/{sessiontemplateName}/sessions/{sessionName}

Requirements

Header: multiplayer_c.h

Library: Microsoft.Xbox.Services.14x.GDK.C.lib

Share via