> ## 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`개까지의 검색 속성만 존재할 수 있습니다. 따라서 해당 속성의 절반을 삭제하는 경우 이 업데이트에서 최대 두 배까지의 고유한 속성을 지정할 수 있습니다.   <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 멤버](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyServerPostUpdate](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdate.md)
- [PFLobbyPostUpdate](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbypostupdate.md)
- [PFMultiplayer C/C++ API 개요 - PFLobby.h](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [PlayFab Multiplayer C++ SDK 릴리스 정보](/ko/services/playfab/multiplayer/lobby/lobby-matchmaking-sdks/lobby-and-matchmaking-release-notes.md)
- [LobbyDataUpdate](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyDataUpdate/LobbyDataUpdate.md)