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

检索大厅会话的关联句柄。

## 语法

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

### 参数

*correlationId*   \_Out\_\
类型：[XblGuid\*](/reference/live/xsapi-c/types_c/structs/xblguid)

传回大厅会话的关联句柄，如果大厅会话不存在则为 null。返回指针的内存在下次调用 [XblMultiplayerManagerDoWork](/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerdowork) 之前保持有效。

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

此函数检索多人游戏管理器 (MPM) 中大厅会话的关联句柄。关联句柄用作大厅会话的别名，允许游戏仅使用关联句柄来引用大厅会话。关联句柄可用于查询跟踪日志中与大厅会话相关的条目。有关详细信息，请参阅[多人游戏概念概述](/services/xbox-services/multiplayer/concepts/live-multiplayer-concepts)。

## 要求

**头文件：** multiplayer\_manager\_c.h

**库：** Microsoft.Xbox.Services.14x.GDK.C.lib

## 另请参阅

[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](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsessionreference.md)
- [XblMultiplayerManagerGameSessionCorrelationId](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessioncorrelationid.md)
- [XblMultiplayerManagerLobbySessionIsHost](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionishost.md)
- [XblMultiplayerManagerLobbySessionInviteUsers](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)
- [XblMultiplayerManagerLobbySessionInviteFriends](/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninvitefriends.md)