跳轉到主要內容
從大廳中強制移除實體。

語法

參數

lobby   PFLobbyHandle 大廳的控制代碼。 targetMember   PFEntityKey* 要強制移除的成員。 preventRejoin   bool 表示 targetMember 在被移除後是否會被禁止重新加入大廳的旗標。 asyncContext   void*
選用
選用的應用程式定義指標大小內容值,可用來將完成狀態變更與此呼叫建立關聯。

傳回值

類型:HRESULT 如果呼叫成功,則為 S_OK;否則為錯誤碼。可透過 PFMultiplayerGetErrorMessage() 擷取錯誤碼的人類可讀形式。

備註

這是一項非同步作業。成功完成時,遊戲會收到 PFLobbyMemberRemovedStateChange,接著收到 PFLobbyForceRemoveMemberCompletedStateChange::result 欄位設定為 S_OK 的 PFLobbyForceRemoveMemberCompletedStateChange。 失敗完成時,遊戲會收到 PFLobbyForceRemoveMemberCompletedStateChange::result 欄位設定為失敗 HRESULT 的 PFLobbyForceRemoveMemberCompletedStateChange。

此大廳中的其中一個本機 PlayFab 實體必須是擁有者,此作業才會成功。如果起始此作業的本機擁有實體在作業進行期間失去其擁有者狀態,作業將以非同步方式失敗。

這是一項非同步作業。在非同步作業成功完成且 PFMultiplayerStartProcessingLobbyStateChanges 提供 PFLobbyMemberRemovedStateChange 結構之前,透過此方法移除的成員不會從 PFLobbyGetMembers 所傳回的清單中移除。

需求

標頭: PFLobby.h

另請參閱

PFLobby 成員
最後修改於 2026年10月8日