跳轉到主要內容
以玩家身分將更新張貼至大廳。

語法

參數

lobby   PFLobbyHandle 大廳的控制代碼。 localUser   PFEntityKey* 張貼更新的本機使用者。 lobbyUpdate   PFLobbyDataUpdate*
選用
代表 localUser 套用至大廳共用部分的選用更新。如果未提供此項,則必須提供 memberUpdate。 memberUpdate   PFLobbyMemberDataUpdate*
選用
套用至 localUser 所擁有之大廳部分的選用更新。如果未提供此參數,則必須提供 lobbyUpdate。 asyncContext   void*
選用
選用的應用程式定義指標大小內容值,可用來將完成狀態變更與此呼叫建立關聯。

傳回值

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

備註

這是一項非同步作業。成功完成時,遊戲會收到 PFLobbyPostUpdateCompletedStateChange::result 欄位設定為 S_OK 的 PFLobbyPostUpdateCompletedStateChange。 失敗完成時,遊戲會收到 PFLobbyPostUpdateCompletedStateChange::result 欄位設定為失敗的 PFLobbyPostUpdateCompletedStateChange。 如果套用更新會變更大廳的狀態,遊戲稍後會收到 PFLobbyUpdatedStateChange。

此作業成功完成只表示大廳服務已接受更新。在將具有更新狀態的 PFLobbyUpdatedStateChange 提供給遊戲之前,遊戲對大廳狀態的本機檢視不會反映此更新。

lobbyUpdate 包含只能由大廳擁有者修改的欄位。如果指定了其中一個欄位,且 localUser 不是大廳的擁有者,此方法會傳回錯誤。

如果代表單一實體同時向此方法提供 lobbyUpdate 和 memberUpdate,兩個更新會以不可分割的方式進行。

需求

標頭: PFLobby.h

另請參閱

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