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