语法
参数
lobby PFLobbyHandle
大厅的句柄。
localUser PFEntityKey*
发布更新的本地用户。
lobbyUpdate PFLobbyDataUpdate*optional 代表
localUser 应用到大厅共享部分的可选更新。如果未提供,则必须提供 memberUpdate。
memberUpdate PFLobbyMemberDataUpdate*optional 应用于
localUser 拥有的大厅部分的可选更新。如果未提供此参数,则必须提供 lobbyUpdate。
asyncContext void*optional 一个可选的、应用定义的、指针大小的上下文值,可用于将完成状态更改与此调用相关联。
返回值
类型:HRESULT 如果调用成功,则为S_OK;否则为错误代码。可通过 PFMultiplayerGetErrorMessage() 检索错误代码的可读形式。
备注
这是一个异步操作。成功完成后,将向标题提供一个 PFLobbyPostUpdateCompletedStateChange,其中 PFLobbyPostUpdateCompletedStateChange::result 字段设置为S_OK。完成失败时,将向标题提供一个 PFLobbyPostUpdateCompletedStateChange,其中 PFLobbyPostUpdateCompletedStateChange::result 字段设置为失败。如果应用更新会改变大厅的状态,则将在稍后向标题提供一个 PFLobbyUpdatedStateChange。此操作成功完成仅表示大厅服务已接受更新。在向标题提供包含更新状态的 PFLobbyUpdatedStateChange 之前,标题的本地大厅状态视图不会反映此更新。
lobbyUpdate 包含只能由大厅所有者修改的字段。如果指定了其中一个字段并且 localUser 不是大厅的所有者,则此方法将返回错误。 如果为单个实体同时向此方法提供了
lobbyUpdate 和 memberUpdate,则这两个更新将以原子方式发生。
要求
头文件: PFLobby.h另请参阅
PFLobby 成员PFLobbyServerPostUpdate
