Skip to main content
使用另一个服务(例如匹配)提供的排列字符串加入大厅。如果尚无人加入该大厅,则使用配置参数对其进行初始化。

语法

参数

handle   PFMultiplayerHandle PFMultiplayer API 实例的句柄。 newMember   PFEntityKey* 加入大厅的本地 PlayFab 实体。 arrangementString   char*
is null-terminated
该实体加入大厅所使用的排列字符串。 configuration   PFLobbyArrangedJoinConfiguration* 在尚无人加入大厅时用于初始化大厅的初始配置数据。 asyncContext   void*
optional
一个可选的、应用定义的、指针大小的上下文值,可用于将完成状态更改与此调用相关联。 lobby   PFLobbyHandle*
optional, library-allocated output
可选的输出大厅对象,可用于在此操作完成后立即排队执行操作。

返回值

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

备注

这是一个异步操作。成功完成后,将向标题依次提供一个 PFLobbyMemberAddedStateChange 以及一个 PFLobbyJoinArrangedLobbyCompletedStateChange,其中 PFLobbyJoinArrangedLobbyCompletedStateChange::result 字段设置为 S_OK。完成失败时,将向标题提供一个 PFLobbyJoinArrangedLobbyCompletedStateChange,其中 PFLobbyJoinArrangedLobbyCompletedStateChange::result 字段设置为失败。

通过此库使用匹配时,可将 PFMatchmakingMatchDetails::lobbyArrangementString 与此方法一起使用,以加入包含所有一起匹配的用户的大厅。

要求

头文件: PFLobby.h

另请参阅

PFLobby 成员
最后修改于 2026年8月13日