語法
參數
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
