> ## 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.

# XblMultiplayerManagerLobbySessionCorrelationId

> XblMultiplayerManagerLobbySessionCorrelationId

# XblMultiplayerManagerLobbySessionCorrelationId

Retrieves the correlation handle for the lobby session.

## Syntax

```cpp theme={null}
HRESULT XblMultiplayerManagerLobbySessionCorrelationId(  
         XblGuid* correlationId  
)  
```

### Parameters

*correlationId*   \_Out\_\
Type: [XblGuid\*](/reference/live/xsapi-c/types_c/structs/xblguid)

Passes back the correlation handle for the lobby session, or null if a lobby session doesn't exist. The memory for the returned pointer remains valid until the next call to [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork).

### Return value

Type: HRESULT

HRESULT return code for this API operation.

## Remarks

This function retrieves the correlation handle for the lobby session in Multiplayer Manager (MPM). The correlation handle serves as an alias for the lobby session, allowing a game to refer to a lobby session by using only the correlation handle. The correlation handle can be used to query trace logs for entries that relate to the lobby session. For more information, see [Multiplayer concepts overview](/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts).

## Requirements

**Header:** multiplayer\_manager\_c.h

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

## See also

[multiplayer\_manager\_c](/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members)\
[XblMultiplayerManagerLobbySessionSessionReference](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsessionreference)


## Related topics

- [XblMultiplayerManagerLobbySessionSessionReference](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsessionreference.md)
- [XblMultiplayerManagerGameSessionCorrelationId](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessioncorrelationid.md)
- [XblMultiplayerManagerLobbySessionIsHost](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionishost.md)
- [XblMultiplayerManagerLobbySessionInviteFriends](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md)
- [XblMultiplayerManagerLobbySessionInviteUsers](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)