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

# PFLobbyGetServerConnectionStatus

> PFLobbyGetServerConnectionStatus 参考，用于在 PlayFab Multiplayer C++ SDK 中查询大厅服务器与通知服务的连接状态。

检索大厅服务器与通知服务的连接状态。

## 语法

```cpp theme={null}
HRESULT PFLobbyGetServerConnectionStatus(  
    PFLobbyHandle lobby,  
    PFLobbyServerConnectionStatus* connectionStatus  
)  
```

### 参数

**`lobby`**   PFLobbyHandle

大厅的句柄。

**`connectionStatus`**   [PFLobbyServerConnectionStatus\*](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyserverconnectionstatus.md)\
*output*

服务器的输出连接状态。

### 返回值

类型：HRESULT

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

## 备注

加入大厅时，库会与 PlayFab PubSub 通知服务建立 WebSocket 连接。此连接用于向库提供有关大厅的实时更新。此方法可用于确定大厅服务器的连接状态，这对于诊断大厅服务器接收大厅更新的能力非常有用。\
\
 非拥有者大厅服务器只能加入客户端拥有的大厅。如果没有服务器加入客户端拥有的大厅，此方法会返回相应的错误代码。  \
\
 通过调用 [PFMultiplayerJoinLobbyAsServer()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobbyasserver.md) 仍处于异步加入大厅过程中的大厅服务器，将看到其连接状态为 [PFLobbyServerConnectionStatus::NotConnected](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyserverconnectionstatus.md)，直到连接建立完成。  \
\
 大厅服务器连接状态的变化通过一个 [PFLobbyUpdatedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange.md) 通知给标题，其中 `PFLobbyUpdatedStateChange::serverConnectionStatusUpdated` 字段设置为 true。

## 要求

**头文件：** PFLobby.h

## 另请参阅

[PFLobby 成员](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [PlayFab Multiplayer C++ SDK 发行说明](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFMultiplayer C/C++ API 概览 - PFLobby.h](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [Lobby.GetServerConnectionStatus](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetServerConnectionStatus.md)
- [LobbyServerConnectionStatus](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyServerConnectionStatus.md)
- [PFLobbyServerConnectionStatus](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyserverconnectionstatus.md)