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

# 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\*](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

要强制移除的成员。

**`preventRejoin`**   bool

一个标志,指示 `targetMember` 在被移除后是否会被阻止重新加入大厅。

**`asyncContext`**   void\*
*可选*

一个可选的、由应用定义的、指针大小的上下文值,可用于将完成状态更改与此次调用相关联。

### 返回值

类型:HRESULT

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

## 备注

这是一个异步操作。成功完成时,游戏将获得一个 [PFLobbyMemberRemovedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberremovedstatechange),随后是一个 [PFLobbyForceRemoveMemberCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyforceremovemembercompletedstatechange),其 [PFLobbyForceRemoveMemberCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyforceremovemembercompletedstatechange) 字段被设置为 `S_OK`。失败完成时,游戏将获得一个 [PFLobbyForceRemoveMemberCompletedStateChange](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyforceremovemembercompletedstatechange),其 [PFLobbyForceRemoveMemberCompletedStateChange::result](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyforceremovemembercompletedstatechange) 字段被设置为失败的 hresult。<br /><br /> 此大厅中出现的本地 PlayFab 实体之一必须是所有者,此操作才能成功。如果发起此操作的本地拥有实体在操作进行期间失去其所有权状态,该操作将异步失败。<br /><br /> 这是一个异步操作。通过此方法移除的成员在异步操作成功完成并且 [PFMultiplayerStartProcessingLobbyStateChanges](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerstartprocessinglobbystatechanges) 提供 `PFLobbyMemberRemovedStateChange` 结构之前,不会从 [PFLobbyGetMembers](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers) 返回的列表中移除。

## 要求

**头文件:** PFLobby.h

## 另请参阅

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


## Related topics

- [PFLobbyMemberRemovedStateChange](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberremovedstatechange.md)
- [PFLobbyGetMemberConnectionStatus](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmemberconnectionstatus.md)
- [同时使用大厅和匹配](/zh-CN/services/playfab/multiplayer/lobby/lobby-and-matchmaking.md)
- [PFMultiplayer C/C++ API 概览 - PFLobby.h](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [PFLobbyStateChangeType](/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbystatechangetype.md)