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

# PFLobbyDataUpdate

> 用於更新 PlayFab Multiplayer 大廳共用部分的要求結構，包括屬性、搜尋資料以及擁有者或成員資格設定。

對大廳共用部分進行更新的要求。

## 語法

```cpp theme={null}
struct PFLobbyDataUpdate {  
    const PFEntityKey* newOwner;  
    const uint32_t* maxMemberCount;  
    const PFLobbyAccessPolicy* accessPolicy;  
    const PFLobbyMembershipLock* membershipLock;  
    uint32_t searchPropertyCount;  
    const char* const* searchPropertyKeys;  
    const char* const* searchPropertyValues;  
    uint32_t lobbyPropertyCount;  
    const char* const* lobbyPropertyKeys;  
    const char* const* lobbyPropertyValues;  
    const bool* restrictInvitesToLobbyOwner;  
}  
```

### 成員

**`newOwner`**   const [PFEntityKey](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\*\
*可能為 nullptr*

選用的大廳新擁有者。

只有在下列其中一種條件下才能更新此值：

* 更新此欄位的成員是大廳目前的擁有者
* 擁有者移轉原則為 `PFLobbyOwnerMigrationPolicy::Manual` 且目前沒有擁有者
* 擁有者移轉原則為 `PFLobbyOwnerMigrationPolicy::None` <br /><br /> 如果此大廳是用戶端擁有的 (目前擁有者是 title\_player\_account 實體)，新擁有者也必須是 title\_player\_account 實體。如果此大廳是伺服器擁有的 (目前擁有者是 game\_server 實體)，新擁有者也必須是 game\_server 實體。

**`maxMemberCount`**   const uint32\_t\*\
*可能為 nullptr*

選用的此大廳成員數目更新容量。

此新值必須大於大廳中目前的成員數目，且小於 `PFLobbyMaxMemberCountUpperLimit`。 <br /><br /> 此值只能由目前的大廳擁有者更新。

**`accessPolicy`**   const [PFLobbyAccessPolicy](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyaccesspolicy)\*\
*可能為 nullptr*

選用的此大廳更新存取原則。

此值只能由目前的大廳擁有者更新。

**`membershipLock`**   const [PFLobbyMembershipLock](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymembershiplock)\*\
*可能為 nullptr*

選用的此大廳成員資格鎖定更新。

此值只能由目前的大廳擁有者更新。

**`searchPropertyCount`**   uint32\_t

要更新的搜尋屬性數目。

只有目前的大廳擁有者可以更新搜尋屬性。 <br /><br /> 在任何指定時間，最多只能有 `PFLobbyMaxSearchPropertyCount` 個並行的搜尋屬性。因此，如果其中一半的屬性正在被刪除，此更新中最多可以指定兩倍數量的唯一屬性。   <br /><br /> 如果違反屬性限制，整個更新作業都會失敗。

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

要更新之搜尋屬性的索引鍵。

只有目前的大廳擁有者可以更新大廳屬性。 <br /><br /> 搜尋屬性會以中繼資料的形式對大廳的非成員顯示，可用於篩選和排序大廳搜尋結果。   <br /><br /> 只有此索引鍵清單中指定的屬性會被更新。如果索引鍵尚不存在，則會建立該屬性。如果新的屬性值為 nullptr，則會刪除該屬性。此清單中省略的任何現有屬性將保持不變。   <br /><br /> 搜尋屬性的格式必須為 string\_keyN 或 number\_keyN，其中 "N" 是介於 1 和 `PFLobbyMaxSearchPropertyCount` 之間的數字。例如 string\_key1、number\_key14 等。 <br />
**`searchPropertyValues`**   const char\* const\*\
*大小為 `searchPropertyCount` 的陣列*

要更新之搜尋屬性的值。

只有目前的大廳擁有者可以更新搜尋屬性。 <br /><br /> 搜尋屬性會以中繼資料的形式對大廳的非成員顯示，可用於篩選和排序大廳搜尋結果。   <br /><br /> 若要刪除值，請提供 nullptr 作為其新值。

**`lobbyPropertyCount`**   uint32\_t

要更新的大廳屬性數目。

只有目前的大廳擁有者可以更新大廳屬性。 <br /><br /> 在任何指定時間，最多只能有 `PFLobbyMaxLobbyPropertyCount` 個並行的大廳屬性。因此，如果其中一半的屬性正在被刪除，此更新中最多可以指定兩倍數量的唯一屬性。   <br /><br /> 如果違反屬性限制，整個更新作業都會失敗。

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

要更新之大廳屬性的索引鍵。

只有目前的大廳擁有者可以更新大廳屬性。 <br /><br /> 大廳屬性只有大廳的成員才能看到。   <br /><br /> 只有此索引鍵清單中指定的屬性會被更新。如果索引鍵尚不存在，則會建立該屬性。如果新的屬性值為 nullptr，則會刪除該屬性。此清單中省略的任何現有屬性將保持不變。

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

要更新之大廳屬性的值。

只有目前的大廳擁有者可以更新大廳屬性。 <br /><br /> 大廳屬性只有大廳的成員才能看到。   <br /><br /> 若要刪除值，請提供 nullptr 作為其新值。

**`restrictInvitesToLobbyOwner`**   const bool\*\
*可能為 nullptr*

選用的原則更新，用於設定是否只有大廳擁有者可以傳送加入大廳的邀請。

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

## 備註

大廳共用部分中的大部分資料只能由擁有者更新。請查看每個欄位的文件以進行確認。

## 需求

**標頭：** PFLobby.h

## 另請參閱

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


## Related topics

- [PFLobbyServerPostUpdate](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)
- [PFLobbyPostUpdate](/zh-TW/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbypostupdate.md)
- [PlayFab Multiplayer C++ SDK 版本資訊](/zh-TW/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [LobbyDataUpdate](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyDataUpdate/LobbyDataUpdate.md)
- [LobbyDataUpdate 類別](/zh-TW/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyDataUpdate/overview.md)