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

# XblMultiplayerManagerLobbySessionCorrelationId

> XblMultiplayerManagerLobbySessionCorrelationId

# XblMultiplayerManagerLobbySessionCorrelationId

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

## 语法

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

### 参数

*correlationId*   \_Out\_\
类型：[XblGuid\*](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/types_c/structs/xblguid.md)

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

### 返回值

类型：HRESULT

此 API 操作的 HRESULT 返回代码。

## 备注

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

## 要求

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

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

## 另请参阅

[multiplayer\_manager\_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)\
[XblMultiplayerManagerLobbySessionSessionReference](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsessionreference.md)


## Related topics

- [XblMultiplayerManagerLobbySessionSessionReference](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionsessionreference.md)
- [multiplayer_manager_c](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/multiplayer_manager_c_members.md)
- [XblMultiplayerManagerGameSessionCorrelationId](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagergamesessioncorrelationid.md)
- [XblMultiplayerManagerLobbySessionIsHost](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessionishost.md)
- [XblMultiplayerManagerLobbySessionInviteUsers](https://docs.xbox.com/zh-CN/reference/live/xsapi-c/multiplayer_manager_c/functions/xblmultiplayermanagerlobbysessioninviteusers.md)