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

# PFLobbyGetServerConnectionStatus

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

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

## 语法

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

### 参数

**`lobby`**   PFLobbyHandle

大厅的句柄。

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

服务器的输出连接状态。

### 返回值

类型：HRESULT

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

## 备注

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

## 要求

**头文件：** 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)
- [Lobby.GetServerConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetServerConnectionStatus.md)
- [LobbyServerConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyServerConnectionStatus.md)
- [PFLobbyServerConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyserverconnectionstatus.md)
