XblMultiplayerSessionCreateHandle

Creates a new local multiplayer session.

Syntax

XblMultiplayerSessionHandle XblMultiplayerSessionCreateHandle(  
         uint64_t xuid,  
         const XblMultiplayerSessionReference* sessionReference,  
         const XblMultiplayerSessionInitArgs* initArgs  
)  

Parameters

xuid   _In_
Type: uint64_t

The Xbox User ID of the user who is creating this session.

sessionReference   _In_opt_
Type: XblMultiplayerSessionReference*

A reference that uniquely identifies the session.

initArgs   _In_opt_
Type: XblMultiplayerSessionInitArgs*

Additional args used to initialize the session. Must also include the sessionReference if these are included.

Return value

Type: XblMultiplayerSessionHandle

Handle to a local multiplayer session.

Remarks

You must call XblMultiplayerWriteSessionAsync after this to write batched local changes to the service. If this is called without XblMultiplayerWriteSessionAsync, this will only create a local session object, but does not commit it to the service. When the local session object is no longer needed, call XblMultiplayerSessionCloseHandle.

Requirements

Header: multiplayer_c.h

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

See also

multiplayer_c