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

# PFLobbyServerDataUpdate

> 속성 및 검색 데이터를 포함하여 게임 서버가 클라이언트 소유 PlayFab Multiplayer 로비의 서버 소유 상태를 업데이트하는 데 사용하는 요청 구조입니다.

클라이언트 소유 로비의 관련 서버 상태에 대한 업데이트 요청입니다.

## 구문

```cpp theme={null}
struct PFLobbyServerDataUpdate {  
    const PFEntityKey* newServer;  
    uint32_t serverPropertyCount;  
    const char* const* serverPropertyKeys;  
    const char* const* serverPropertyValues;  
}  
```

### 멤버

**`newServer`**   const [PFEntityKey](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pfmultiplayer/pfentitykey_clientsdk)\*\
*nullptr일 수 있음*

클라이언트 소유 로비와 연결할 선택적인 새 서버입니다.

지정된 경우 이 엔터티는 game\_server 엔터티여야 합니다. <br /><br /> 로비에는 한 번에 하나의 서버만 연결할 수 있습니다. 여기에 새 서버를 설정하면 로비에서 현재 연결된 서버가 대체됩니다.

**`serverPropertyCount`**   uint32\_t

업데이트할 서버 속성의 수입니다.

언제든지 동시에 `PFLobbyMaxServerPropertyCount`개까지의 속성만 존재할 수 있습니다. 따라서 해당 속성의 절반을 삭제하는 경우 이 업데이트에서 최대 두 배까지의 고유한 속성을 지정할 수 있습니다. <br /><br /> 속성 제한을 위반하면 전체 업데이트 작업이 실패합니다.

**`serverPropertyKeys`**   const char\* const\*\
*크기 `serverPropertyCount`의 배열*

업데이트할 서버 속성의 키입니다.

<br /><br /> 이 키 목록에 지정된 속성만 업데이트됩니다. 키가 아직 존재하지 않으면 속성이 만들어집니다. 새 속성 값이 nullptr이면 속성이 삭제됩니다. 이 목록에서 생략된 기존 속성은 수정되지 않은 채 유지됩니다.

**`serverPropertyValues`**   const char\* const\*\
*크기 `serverPropertyCount`의 배열*

업데이트할 서버 속성의 값입니다.

<br /><br /> 값을 삭제하려면 새 값으로 nullptr를 제공합니다.

## 요구 사항

**헤더:** PFLobby.h

## 참고 항목

[PFLobby 멤버](/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members)


## Related topics

- [PFLobbyServerPostUpdateAsServer](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/functions/pflobbyserverpostupdateasserver.md)
- [PFMultiplayer C/C++ API 개요 - PFLobby.h](/ko/services/playfab/multiplayer/lobby/playfabmultiplayerreference-cpp/pflobby/pflobby_members.md)
- [LobbyServerDataUpdate method](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyServerDataUpdate/LobbyServerDataUpdate.md)
- [LobbyServerDataUpdate class](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyServerDataUpdate/overview.md)
- [LobbyServerDataUpdate.NewServer](/ko/services/playfab/multiplayer/lobby/unity-multiplayer-api-reference/PlayFab.Multiplayer/LobbyServerDataUpdate/NewServer.md)