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

# PFMultiplayerCreateAndJoinLobby

> 透過 PlayFab Multiplayer C++ SDK 建立新的 PlayFab 大廳並將建立者用戶端實體新增至其中的 PFMultiplayerCreateAndJoinLobby 參考。

建立新的大廳並將建立者 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\*](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)

建立大廳的本機 PlayFab 實體。

**`createConfiguration`**   [PFLobbyCreateConfiguration\*](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateconfiguration)

建立大廳時使用的初始設定資料。

**`joinConfiguration`**   [PFLobbyJoinConfiguration\*](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbyjoinconfiguration)

建立並加入大廳之成員的初始設定資料。

**`asyncContext`**   void\*\
*選用*

選用的應用程式定義指標大小內容值，可用來將完成狀態變更與此呼叫建立關聯。

**`lobby`**   PFLobbyHandle\*\
*選用，程式庫配置的輸出*

選用的輸出大廳物件，可用於將作業排入佇列，以便在此作業完成時立即執行。

### 傳回值

類型：HRESULT

如果呼叫成功，則為 `S_OK`；否則為錯誤碼。可透過 [PFMultiplayerGetErrorMessage()](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/functions/pfmultiplayergeterrormessage) 擷取錯誤碼的人類可讀形式。

## 備註

這是一項非同步作業。成功完成時，遊戲會收到 [PFLobbyMemberAddedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbymemberaddedstatechange)，接著收到 [PFLobbyCreateAndJoinLobbyCompletedStateChange::result](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange) 欄位設定為 `S_OK` 的 [PFLobbyCreateAndJoinLobbyCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange)。 失敗完成時，遊戲會收到 [PFLobbyCreateAndJoinLobbyCompletedStateChange::result](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange) 欄位設定為失敗的 [PFLobbyCreateAndJoinLobbyCompletedStateChange](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/structs/pflobbycreateandjoinlobbycompletedstatechange)。

## 需求

**標頭：** PFLobby.h

## 另請參閱

[PFLobby 成員](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyGetLobbyProperty](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbyproperty.md)
- [PFLobbyGetLobbyPropertyKeys](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetlobbypropertykeys.md)
- [PFLobbyGetMembers](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetmembers.md)
- [Lobby SDK 快速入門](/zh-TW/services/playfab/multiplayer/lobby/lobby-getting-started.md)
- [PFLobbyGetSearchProperty](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbygetsearchproperty.md)