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

# PFLobbyGetMemberConnectionStatus

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

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

## 語法

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

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

**`member`**   [PFEntityKey\*](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)

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

**`connectionStatus`**   [PFLobbyMemberConnectionStatus\*](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus.md)\
*輸出*

輸出的成員連線狀態。

### 傳回值

類型：HRESULT

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

## 備註

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

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PlayFab Multiplayer C++ SDK 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFMultiplayer C/C++ API 概觀 - PFLobby.h](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [GetMemberConnectionStatus](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/Lobby/GetMemberConnectionStatus.md)
- [PFLobbyMemberConnectionStatus](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymemberconnectionstatus.md)
- [LobbyMemberConnectionStatus](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyMemberConnectionStatus.md)