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

> 在 PlayFab Multiplayer C++ SDK 中查詢大廳伺服器與通知服務之連線狀態的 PFLobbyGetServerConnectionStatus 參考。

擷取大廳伺服器與通知服務的連線狀態。

## 語法

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

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

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

輸出的伺服器連線狀態。

### 傳回值

類型：HRESULT

如果呼叫成功，則為 `S_OK`；否則為錯誤碼。可透過 [PFMultiplayerGetErrorMessage()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) 擷取錯誤碼的人類可讀形式。

## 備註

加入大廳時，程式庫會建立與 PlayFab PubSub 通知服務的 WebSocket 連線。此連線用於向程式庫提供有關大廳的即時更新。此方法可用於判斷大廳伺服器的連線狀態，有助於診斷大廳伺服器接收大廳更新的能力。<br /><br /> 非擁有者的大廳伺服器只能加入用戶端擁有的大廳。如果沒有伺服器加入用戶端擁有的大廳，此方法會傳回適當的錯誤碼。   <br /><br /> 仍在透過呼叫 [PFMultiplayerJoinLobbyAsServer()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobbyasserver) 以非同步方式加入大廳的大廳伺服器，在建立連線之前，其連線狀態會顯示為 [PFLobbyServerConnectionStatus::NotConnected](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyserverconnectionstatus)。   <br /><br /> 大廳伺服器連線狀態的變更會透過 `PFLobbyUpdatedStateChange::serverConnectionStatusUpdated` 欄位設定為 true 的 [PFLobbyUpdatedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange) 告知遊戲。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PlayFab Multiplayer C++ SDK 版本資訊](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [Lobby.GetServerConnectionStatus](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetServerConnectionStatus.md)
- [LobbyServerConnectionStatus](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyServerConnectionStatus.md)
- [PFLobbyServerConnectionStatus](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyserverconnectionstatus.md)
- [PFLobbyGetMemberConnectionStatus](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)