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

# XblMultiplayerWriteSessionByHandleResult

> XblMultiplayerWriteSessionByHandleResult

Gets the result of a XblMultiplayerWriteSessionAsync operation.

## Syntax

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

### Parameters

*async*   \_Inout\_\
Type: XAsyncBlock\*

The AsyncBlock for this operation.

*handle*   \_Out\_\
Type: [XblMultiplayerSessionHandle\*](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/handles/xblmultiplayersessionhandle.md)

Passes back a handle to a new instance of a local multiplayer session object. It must be release by the caller with [XblMultiplayerSessionCloseHandle](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionclosehandle.md). If the updated session object is not needed, passing nullptr will cause the new multiplayer session object to be cleaned up immediately.

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

Note that if you leave a session that you are the last member of and the sessionEmptyTimeout is equal to 0, then the session will be deleted immediately and a nullptr will be returned.

## Requirements

**Header:** multiplayer\_c.h

**Library:** Microsoft.Xbox.Services.142.C.lib or Microsoft.Xbox.Services.143.C.lib

## See also

[multiplayer\_c](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members.md)


## Related topics

- [multiplayer_c (contents)](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/multiplayer_c_members.md)
- [XblMultiplayerWriteSessionResult](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionresult.md)
- [XblMultiplayerWriteSessionAsync](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionasync.md)
- [XblMultiplayerWriteSessionByHandleAsync](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayerwritesessionbyhandleasync.md)
- [XblMultiplayerSessionWriteStatus](https://docs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayersessionwritestatus.md)