语法
参数
lobby PFLobbyHandle
大厅的句柄。
localUser PFEntityKey*
要作为成员添加到大厅的本地用户的 PlayFab 实体键。
memberPropertyCount uint32_t
输入,范围为 0,PFLobbyMaxMemberPropertyCount
此用户加入大厅时要为其设置的初始成员属性数量。
memberPropertyKeys char* const*
大小为 memberPropertyCount 的输入数组
此用户加入大厅时要为其设置的初始成员属性的键。
memberPropertyValues char* const*
大小为 memberPropertyCount 的输入数组
此用户加入大厅时要为其设置的初始成员属性的值。
asyncContext void*
可选
一个可选的、由应用定义的、指针大小的上下文值,可用于将完成状态更改与此次调用相关联。
返回值
类型:HRESULT 如果调用成功,则为S_OK,否则为错误代码。可通过 PFMultiplayerGetErrorMessage() 获取错误代码的可读形式。
备注
这是一个异步操作。成功完成时,游戏将获得一个 PFLobbyMemberAddedStateChange,随后是一个 PFLobbyAddMemberCompletedStateChange,其 PFLobbyAddMemberCompletedStateChange::result 字段被设置为S_OK。失败完成时,游戏将获得一个 PFLobbyAddMemberCompletedStateChange,其 PFLobbyAddMemberCompletedStateChange::result 字段被设置为失败的 hresult。此方法用于将另一个本地 PlayFab 实体添加到已存在的大厅对象中。由于大厅对象必须已经通过调用 PFMultiplayerCreateAndJoinLobby 或 PFMultiplayerJoinLobby 创建,因此此方法主要用于多本地用户的场景。
这是一个异步操作。通过此方法添加的成员在异步操作成功完成并且 PFMultiplayerStartProcessingLobbyStateChanges 提供
PFLobbyMemberAddedStateChange 结构之前,不会反映在 PFLobbyGetMembers 返回的列表中。