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

# PFLobbyForceRemoveMember

> PlayFab Multiplayer C++ SDK 中的 PFLobbyForceRemoveMember 參考，可讓大廳擁有者從其擁有的大廳中強制移除另一個 PlayFab 實體。

從大廳中強制移除實體。

## 語法

```cpp theme={null}
HRESULT PFLobbyForceRemoveMember(  
    PFLobbyHandle lobby,  
    const PFEntityKey* targetMember,  
    bool preventRejoin,  
    void* asyncContext  
)  
```

### 參數

**`lobby`**   PFLobbyHandle

大廳的控制代碼。

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

要強制移除的成員。

**`preventRejoin`**   bool

表示 `targetMember` 在被移除後是否會被禁止重新加入大廳的旗標。

**`asyncContext`**   void\*\
*選用*

選用的應用程式定義指標大小內容值，可用來將完成狀態變更與此呼叫建立關聯。

### 傳回值

類型：HRESULT

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

## 備註

這是一項非同步作業。成功完成時，遊戲會收到 [PFLobbyMemberRemovedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberremovedstatechange.md)，接著收到 [PFLobbyForceRemoveMemberCompletedStateChange::result](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyforceremovemembercompletedstatechange.md) 欄位設定為 `S_OK` 的 [PFLobbyForceRemoveMemberCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyforceremovemembercompletedstatechange.md)。 失敗完成時，遊戲會收到 [PFLobbyForceRemoveMemberCompletedStateChange::result](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyforceremovemembercompletedstatechange.md) 欄位設定為失敗 HRESULT 的 [PFLobbyForceRemoveMemberCompletedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyforceremovemembercompletedstatechange.md)。 \
\
 此大廳中的其中一個本機 PlayFab 實體必須是擁有者，此作業才會成功。如果起始此作業的本機擁有實體在作業進行期間失去其擁有者狀態，作業將以非同步方式失敗。   \
\
 這是一項非同步作業。在非同步作業成功完成且 [PFMultiplayerStartProcessingLobbyStateChanges](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges.md) 提供 `PFLobbyMemberRemovedStateChange` 結構之前，透過此方法移除的成員不會從 [PFLobbyGetMembers](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md) 所傳回的清單中移除。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PFLobbyMemberRemovedStateChange](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberremovedstatechange.md)
- [PFLobbyGetMemberConnectionStatus](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)
- [搭配使用大廳和配對](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
- [PFLobbyStateChangeType](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbystatechangetype.md)
- [PFMultiplayer C/C++ API 概觀 - PFLobby.h](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)