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

# PFLobbyGetMemberConnectionStatus

> PFLobbyGetMemberConnectionStatus 参考，用于在 Multiplayer C++ SDK 中查询 PlayFab 大厅成员是否已连接到通知服务。

确定成员与通知服务的连接状态。

## 语法

```cpp theme={null}
HRESULT PFLobbyGetMemberConnectionStatus(  
    PFLobbyHandle lobby,  
    const PFEntityKey* member,  
    PFLobbyMemberConnectionStatus* connectionStatus  
)  
```

### 参数

**`lobby`**   PFLobbyHandle

大厅的句柄。

**`member`**   [PFEntityKey\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

将被检查连接状态的成员。

**`connectionStatus`**   [PFLobbyMemberConnectionStatus\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus)\
*output*

成员的输出连接状态。

### 返回值

类型：HRESULT

如果调用成功，则为 `S_OK`；否则为错误代码。可通过 [PFMultiplayerGetErrorMessage()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) 检索错误代码的可读形式。

## 备注

加入大厅时，库会与 PlayFab PubSub 通知服务建立 WebSocket 连接。此连接用于向库提供有关大厅的实时更新。此方法可用于确定成员的连接状态，这对于诊断成员接收大厅更新的能力非常有用。<br /><br /> 通过调用 [PFMultiplayerCreateAndJoinLobby()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby)、[PFMultiplayerJoinLobby()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby) 或 [PFLobbyAddMember](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyaddmember) 之一仍处于异步加入大厅过程中的本地成员，将看到其连接状态为 [PFLobbyMemberConnectionStatus::NotConnected](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus)，直到连接建立完成。  <br /><br /> 当用户的连接状态发生变化时，将向标题提供一个 [PFLobbyMemberUpdateSummary](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberupdatesummary)，其中 `PFLobbyMemberUpdateSummary::member` 字段设置为该用户的实体键，且 `PFLobbyMemberUpdateSummary::connectionStatusUpdated` 字段设置为 true。`PFLobbyMemberUpdateSummary` 将通过 [PFMultiplayerStartProcessingLobbyStateChanges()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges) 作为 [PFLobbyUpdatedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange) 结构上的 `memberUpdates` 条目提供给标题。  <br /><br /> 当用户的连接状态从 [PFLobbyMemberConnectionStatus::Connected](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus) 变为 [PFLobbyMemberConnectionStatus::NotConnected](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus) 时，他们可能正在遇到连接问题，或者他们的游戏可能已崩溃。大厅所有者可以通过 [PFLobbyForceRemoveMember()](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyforceremovemember) 将此类用户从大厅中移除。

## 要求

**头文件：** PFLobby.h

## 另请参阅

[PFLobby 成员](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PlayFab Multiplayer C++ SDK 发行说明](/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFMultiplayer C/C++ API 概览 - PFLobby.h](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [GetMemberConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMemberConnectionStatus.md)
- [PFLobbyMemberConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus.md)
- [LobbyMemberConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyMemberConnectionStatus.md)