PFLobbyServerPostUpdateAsServer

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

语法

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

lobby PFLobbyHandle

大厅的句柄。

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

asyncContext void*
可选

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

类型：HRESULT

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

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

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

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

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

标头： PFLobby.h