PFLobbyServerPostUpdate
以服务器所有者身份将更新发布到大厅。
语法
HRESULT PFLobbyServerPostUpdate(
PFLobbyHandle lobby,
const PFLobbyDataUpdate* lobbyUpdate,
void* asyncContext
)
参数
lobby
PFLobbyHandle
大厅的句柄。
lobbyUpdate
PFLobbyDataUpdate*
代表服务器所有者应用于大厅共享部分的更新。
asyncContext
void*
可选
一个可选应用定义的指针大小的上下文值,可用于将完成状态更改与此调用关联起来。
返回值
类型:HRESULT
如果调用成功,则为 S_OK
,否则为错误代码。 可通过 PFMultiplayerGetErrorMessage() 检索错误代码的可读形式。
备注
若要使用此功能,必须在包含 PFLobby.h 之前定义PFMULTIPLAYER_INCLUDE_SERVER_APIS。
这是一个异步操作。 完成成功后,将向游戏提供 PFLobbyServerPostUpdateCompletedStateChange,PFLobbyServerPostUpdateCompletedStateChange::result 字段设置为 S_OK
。 完成成功后,将向游戏提供 PFLobbyServerPostUpdateCompletedStateChange,PFLobbyServerPostUpdateCompletedStateChange::result 字段设置为失败。 如果应用更新将更改大厅的状态,则会在之后的某个时间向游戏提供 PFLobbyUpdatedStateChange。
此操作成功完成仅表示大厅服务已接受更新。 在向具有更新状态的游戏提供 PFLobbyUpdatedStateChange 之前,游戏的“大厅”状态的本地视图不会反映此更新。
要求
标头: PFLobby.h