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

> 在 Multiplayer C++ SDK 中查詢 PlayFab 大廳成員是否已連線至通知服務的 PFLobbyGetMemberConnectionStatus 參考。

判斷成員與通知服務的連線狀態。

## 語法

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

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

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

要檢查其連線狀態的成員。

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

輸出的成員連線狀態。

### 傳回值

類型：HRESULT

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

## 備註

加入大廳時，程式庫會建立與 PlayFab PubSub 通知服務的 WebSocket 連線。此連線用於向程式庫提供有關大廳的即時更新。此方法可用於判斷成員的連線狀態，有助於診斷成員接收大廳更新的能力。<br /><br /> 仍在透過呼叫 [PFMultiplayerCreateAndJoinLobby()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby)、[PFMultiplayerJoinLobby()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby) 或 [PFLobbyAddMember](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyaddmember) 中的任何一個以非同步方式加入大廳的本機成員，在建立連線之前，其連線狀態會顯示為 [PFLobbyMemberConnectionStatus::NotConnected](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus)。   <br /><br /> 當使用者的連線狀態變更時，遊戲會收到 [PFLobbyMemberUpdateSummary](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberupdatesummary)，其 `PFLobbyMemberUpdateSummary::member` 欄位設定為使用者的實體索引鍵，且 `PFLobbyMemberUpdateSummary::connectionStatusUpdated` 欄位設定為 true。`PFLobbyMemberUpdateSummary` 會透過 [PFMultiplayerStartProcessingLobbyStateChanges()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges)，以 [PFLobbyUpdatedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyupdatedstatechange) 結構上的 `memberUpdates` 項目形式提供給遊戲。   <br /><br /> 當使用者的連線狀態從 [PFLobbyMemberConnectionStatus::Connected](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus) 變更為 [PFLobbyMemberConnectionStatus::NotConnected](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus) 時，他們可能遇到連線問題，或者他們的遊戲可能已當機。大廳擁有者可以透過 [PFLobbyForceRemoveMember()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyforceremovemember) 將這類使用者從大廳中移除。

## 需求

**標頭：** 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)
- [GetMemberConnectionStatus](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMemberConnectionStatus.md)
- [PFLobbyMemberConnectionStatus](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus.md)
- [LobbyMemberConnectionStatus](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyMemberConnectionStatus.md)
- [LobbyMemberUpdateSummary.ConnectionStatusUpdated](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyMemberUpdateSummary/ConnectionStatusUpdated.md)