> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFMultiplayerCreateAndJoinLobby

> PFMultiplayerCreateAndJoinLobby 参考，用于通过 PlayFab Multiplayer C++ SDK 创建新的 PlayFab 大厅并将创建的客户端实体添加至其中。

创建新大厅并将创建它的 PlayFab 实体添加进去。

## 语法

```cpp theme={null}
HRESULT PFMultiplayerCreateAndJoinLobby(  
    PFMultiplayerHandle handle,  
    const PFEntityKey* creator,  
    const PFLobbyCreateConfiguration* createConfiguration,  
    const PFLobbyJoinConfiguration* joinConfiguration,  
    void* asyncContext,  
    PFLobbyHandle* lobby  
)  
```

### 参数

**`handle`**   PFMultiplayerHandle

PFMultiplayer API 实例的句柄。

**`creator`**   [PFEntityKey\*](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk.md)

创建大厅的本地 PlayFab 实体。

**`createConfiguration`**   [PFLobbyCreateConfiguration\*](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateconfiguration.md)

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

**`joinConfiguration`**   [PFLobbyJoinConfiguration\*](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinconfiguration.md)

创建并加入大厅的成员的初始配置数据。

**`asyncContext`**   void\*\
*optional*

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

**`lobby`**   PFLobbyHandle\*\
*optional, library-allocated output*

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

### 返回值

类型：HRESULT

如果调用成功，则为 `S_OK`；否则为错误代码。可通过 [PFMultiplayerGetErrorMessage()](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage.md) 检索错误代码的可读形式。

## 备注

这是一个异步操作。成功完成后，将向标题依次提供一个 [PFLobbyMemberAddedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange.md) 以及一个 [PFLobbyCreateAndJoinLobbyCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange.md)，其中 [PFLobbyCreateAndJoinLobbyCompletedStateChange::result](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange.md) 字段设置为 `S_OK`。完成失败时，将向标题提供一个 [PFLobbyCreateAndJoinLobbyCompletedStateChange](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange.md)，其中 [PFLobbyCreateAndJoinLobbyCompletedStateChange::result](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange.md) 字段设置为失败。

## 要求

**头文件：** PFLobby.h

## 另请参阅

[PFLobby 成员](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)


## Related topics

- [PFLobbyGetLobbyProperty](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyproperty.md)
- [PFLobbyGetLobbyPropertyKeys](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbypropertykeys.md)
- [PFLobbyGetMembers](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md)
- [PFLobbyGetSearchProperty](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchproperty.md)
- [Lobby SDK 快速入门](https://docs.xbox.com/zh-CN/services/playfab/multiplayer/lobby/lobby-getting-started.md)