PFLobbyServerPostUpdateAsServer

作为已加入的服务器向客户端拥有的大厅发布更新。

语法

HRESULT PFLobbyServerPostUpdateAsServer(  
    PFLobbyHandle lobby,  
    const PFLobbyServerDataUpdate* serverUpdate,  
    void* asyncContext  
)  

参数

lobby PFLobbyHandle

大厅的句柄。

serverUpdatePFLobbyServerDataUpdate*

要应用于已加入的服务器所拥有的大厅数据部分的更新。

asyncContext void*
可选

一个可选应用定义的指针大小的上下文值,可用于将完成状态更改与此调用关联起来。

返回值

类型:HRESULT

如果调用成功,则为 S_OK,否则为错误代码。 可通过 PFMultiplayerGetErrorMessage() 检索错误代码的可读形式。

备注

若要使用此功能,必须在包含 PFLobby.h 之前定义PFMULTIPLAYER_INCLUDE_SERVER_APIS。

这是一个异步操作。 完成成功后,会向游戏提供 PFLobbyServerPostUpdateAsServerCompletedStateChange 并将 PFLobbyServerPostUpdateAsServerCompletedStateChange::result 字段设置为 S_OK。 完成失败后,会向游戏提供 PFLobbyServerPostUpdateAsServerCompletedStateChange 并将 PFLobbyServerPostUpdateAsServerCompletedStateChange::result 字段设置为“失败”。 如果应用更新会更改大厅的状态,则会在之后的某个时间向游戏提供 PFLobbyUpdatedStateChange

成功完成此操作仅表示大厅服务已接受更新。 在向状态为“已更新”的游戏提供 PFLobbyUpdatedStateChange 之前,游戏的“大厅”状态的本地视图不会反映此更新。

此操作仅限于使用连接的客户端拥有的大厅。

要求

标头: PFLobby.h

另请参阅

PFLobby 成员
PFLobbyPostUpdate