PFMultiplayerCreateAndClaimServerLobby

创建新大厅作为 game_server 实体。

语法

HRESULT PFMultiplayerCreateAndClaimServerLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* server,  
    const PFLobbyCreateConfiguration* createConfiguration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  

参数

handle PFMultiplayerHandle

PFMultiplayer API 实例的句柄。

serverPFEntityKey*

创建大厅的游戏服务器的 PlayFab 实体密钥。 它的实体类型必须为“game_server”。

createConfigurationPFLobbyCreateConfiguration*

创建大厅时使用的初始配置数据。

asyncContext void*
可选

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

lobby PFLobbyHandle*
可选、库分配的输出

可用于将操作排队以立即执行此操作的可选输出大厅对象完成。

返回值

类型:HRESULT

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

备注

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

这是一个异步操作。 成功完成后,将向游戏提供 PFLobbyCreateAndClaimServerLobbyCompletedStateChangePFLobbyCreateAndClaimServerLobbyCompletedStateChange::result 字段设置为 S_OK。 完成失败后,将向游戏提供 PFLobbyCreateAndClaimServerLobbyCompletedStateChange,其中 PFLobbyCreateAndClaimServerLobbyCompletedStateChange::result 字段设置为失败。

要求

标头: PFLobby.h

另请参阅

PFLobby 成员