Skip to main content

XblMultiplayerGetSessionByHandleAsync

Gets a session object with all its attributes from the server, given a session handle id.

Syntax

Parameters

xblContext   _In_
Type: XblContextHandle
XBOX live context for the local user. handleId   _In_
Type: char*
A multiplayer handle id, which uniquely identifies the session. async   _In_
Type: XAsyncBlock*
The AsyncBlock for this operation.

Return value

Type: HRESULT HRESULT return code for this API operation.

Remarks

A handle is a service-side pointer to a session. The handleId is a GUID identifier of the handle. Callers will usually get the handleId either from another player’s XblMultiplayerActivityDetails, or from an invite.

REST Call

Calls GET /handles//session

Requirements

Header: multiplayer_c.h Library: Microsoft.Xbox.Services.14x.GDK.C.lib

Conceptual documentation

See also

multiplayer_c
Last modified on August 20, 2026