> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerGetSessionByHandleResult

> XblMultiplayerGetSessionByHandleResult

# XblMultiplayerGetSessionByHandleResult

Gets the result of an XblMultiplayerGetSessionByHandleAsync call.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerGetSessionByHandleResult(  
         XAsyncBlock* async,  
         XblMultiplayerSessionHandle* handle  
)  
```

### Parameters

*async*   \_In\_\
Type: XAsyncBlock\*

The AsyncBlock for this operation.

*handle*   \_Out\_\
Type: [XblMultiplayerSessionHandle\*](/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle)

Passes back a handle to a new instance of a local multiplayer session object. It must be release by the caller with [XblMultiplayerSessionCloseHandle](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionclosehandle).

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

If the session does not exist, this API will return \_\_HRESULT\_FROM\_WIN32(ERROR\_RESOURCE\_DATA\_NOT\_FOUND) and a null XblMultiplayerSessionHandle.

## Requirements

**Header:** multiplayer\_c.h

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

## See also

[multiplayer\_c](/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members)


## Related topics

- [XblMultiplayerGetSessionResult](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionresult.md)
- [XblMultiplayerWriteSessionResult](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerWriteSessionByHandleResult](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleresult.md)
- [XblMultiplayerSessionHandleId](/reference/live/xsapi-c/multiplayer_c/structs/xblmultiplayersessionhandleid.md)
- [XblMultiplayerGetSessionByHandleAsync](/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetsessionbyhandleasync.md)