> ## 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](/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](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbyaccesspolicy)\*\
*nullptr の場合があります*

このロビーに対する更新済みのアクセス ポリシー (省略可能)。

この値は、現在のロビー所有者のみが更新できます。

**`membershipLock`**   const [PFLobbyMembershipLock](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/enums/pflobbymembershiplock)\*\
*nullptr の場合があります*

このロビーのメンバーシップ ロックに対する更新 (省略可能)。

この値は、現在のロビー所有者のみが更新できます。

**`searchPropertyCount`**   uint32\_t

更新する検索プロパティの数。

検索プロパティを更新できるのは、現在のロビー所有者のみです。<br /><br /> 同時に存在できる検索プロパティは、任意の時点で `PFLobbyMaxSearchPropertyCount` 件までです。したがって、そのうち半数のプロパティを削除する場合、この更新で指定できる一意なプロパティの数は最大でその 2 倍となります。<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` 件までです。したがって、そのうち半数のプロパティを削除する場合、この更新で指定できる一意なプロパティの数は最大でその 2 倍となります。<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 メンバー](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyServerPostUpdate](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)
- [PFLobbyPostUpdate](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbypostupdate.md)
- [PFMultiplayer C/C++ API 概要 - PFLobby.h](/ja-jp/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [PlayFab Multiplayer C++ SDK リリース ノート](/ja-jp/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [LobbyDataUpdate](/ja-jp/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyDataUpdate/LobbyDataUpdate.md)