> ## 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.

# PFLobbyCreateConfiguration

> 建立 PlayFab Multiplayer 大廳時使用的初始設定資料，包括最大成員計數、存取原則和可搜尋屬性。

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

## 語法

```cpp theme={null}
struct PFLobbyCreateConfiguration {  
    uint32_t maxMemberCount;  
    PFLobbyOwnerMigrationPolicy ownerMigrationPolicy;  
    PFLobbyAccessPolicy accessPolicy;  
    uint32_t searchPropertyCount;  
    const char* const* searchPropertyKeys;  
    const char* const* searchPropertyValues;  
    uint32_t lobbyPropertyCount;  
    const char* const* lobbyPropertyKeys;  
    const char* const* lobbyPropertyValues;  
    bool restrictInvitesToLobbyOwner;  
}  
```

### 成員

**`maxMemberCount`**   uint32\_t

新大廳中允許的最大成員數目。

此值必須至少為 `PFLobbyMaxMemberCountLowerLimit`，且不得超過 `PFLobbyMaxMemberCountUpperLimit`。\
\
&#x20;如果用戶端呼叫 [PFMultiplayerJoinLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayerjoinlobby.md) 或 [PFLobbyAddMember](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyaddmember.md) 會違反此限制，作業將以非同步方式失敗。

**`ownerMigrationPolicy`**   [PFLobbyOwnerMigrationPolicy](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyownermigrationpolicy.md)

新大廳的擁有者移轉原則。

傳遞給 [PFMultiplayerCreateAndJoinLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby.md) 時，此值不能是 `PFLobbyOwnerMigrationPolicy::Server`。傳遞給 [PFMultiplayerCreateAndClaimServerLobby()](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandclaimserverlobby.md) 時，此值必須是 `PFLobbyOwnerMigrationPolicy::Server`。

**`accessPolicy`**   [PFLobbyAccessPolicy](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyaccesspolicy.md)

新大廳的存取原則。

**`searchPropertyCount`**   uint32\_t

新大廳的初始搜尋屬性數目。

**`searchPropertyKeys`**   const char\* const\*\
*大小為 `searchPropertyCount` 的陣列*

新大廳之初始搜尋屬性的索引鍵。

搜尋屬性會以中繼資料的形式對大廳的非成員顯示，可用於篩選和排序大廳搜尋結果。 \
\
&#x20;搜尋屬性的格式必須為 string\_keyN 或 number\_keyN，其中 "N" 是介於 1 和 `PFLobbyMaxSearchPropertyCount` 之間的數字。例如 string\_key1、number\_key14 等。 \

**`searchPropertyValues`**   const char\* const\*\
*大小為 `searchPropertyCount` 的陣列*

新大廳之初始搜尋屬性的值。

搜尋屬性會以中繼資料的形式對大廳的非成員顯示，可用於篩選和排序大廳搜尋結果。

**`lobbyPropertyCount`**   uint32\_t

新大廳的初始大廳屬性數目。

**`lobbyPropertyKeys`**   const char\* const\*\
*大小為 `lobbyPropertyCount` 的陣列*

新大廳之初始大廳屬性的索引鍵。

大廳屬性只有大廳的成員才能看到。

**`lobbyPropertyValues`**   const char\* const\*\
*大小為 `lobbyPropertyCount` 的陣列*

新大廳之初始大廳屬性的值。

大廳屬性只有大廳的成員才能看到。

**`restrictInvitesToLobbyOwner`**   bool

是否只有大廳擁有者可以傳送加入大廳邀請的原則。

為 true 時，只有大廳擁有者可以傳送邀請。為 false 時，任何成員都可以傳送邀請。只有用戶端擁有的大廳才能為 true。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PFMultiplayerCreateAndJoinLobby](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandjoinlobby.md)
- [PFMultiplayerCreateAndClaimServerLobby](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pfmultiplayercreateandclaimserverlobby.md)
- [PlayFab Multiplayer C++ SDK 版本資訊](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [PFMultiplayer C/C++ API 概觀 - PFLobby.h](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [LobbyCreateConfiguration](https://docs.xbox.com/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyCreateConfiguration/LobbyCreateConfiguration.md)
