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

# PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest

> PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest 데이터 모델입니다. 지정된 플레이어의 사용자 지정 속성에 대해 가산적 업데이트를 수행합니다. 플레이어의 사용자 지정 속성을 업데이트할 때 이미 존재하는 속성은 값이 덮어써집니다. 호출에서 지정한 속성 외의 다른 속성은 변경되지 않습니다.

PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest 데이터 모델입니다. 지정된 플레이어의 사용자 지정 속성에 대해 가산적 업데이트를 수행합니다. 플레이어의 사용자 지정 속성을 업데이트할 때 이미 존재하는 속성은 값이 덮어써집니다. 호출에서 지정한 속성 외의 다른 속성은 변경되지 않습니다.

## 구문

```cpp theme={null}
typedef struct PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    int32_t const* expectedPropertiesVersion;  
    PFPlayerDataManagementUpdateProperty const* properties;  
    uint32_t propertiesCount;  
} PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest;  
```

### 멤버

**`customTags`**   [PFStringDictionaryEntry](/ko/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

(선택 사항) 요청과 연결된 선택적 사용자 지정 태그입니다(예: 빌드 번호, 외부 추적 식별자 등).

**`customTagsCount`**   uint32\_t

customTags의 개수입니다.

**`expectedPropertiesVersion`**   int32\_t const\*<br />*may be nullptr*

(선택 사항) 동시성 제어에 사용되는 선택적 필드입니다. 마지막 버전 이후 다른 클라이언트가 플레이어의 속성을 업데이트하지 않은 경우에만 업데이트 작업이 수행되도록 할 수 있습니다.

**`properties`**   [PFPlayerDataManagementUpdateProperty](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementupdateproperty) const\*

플레이어에 대해 설정할 속성의 컬렉션입니다.

**`propertiesCount`**   uint32\_t

properties의 개수입니다.

## 요구 사항

**헤더:** PFPlayerDataManagementTypes.h

## 참고 항목

[PFPlayerDataManagementTypes 멤버](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members)


## Related topics

- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesasync.md)
- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesResult](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientupdateplayercustompropertiesresult.md)
- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesGetResult](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesgetresult.md)
- [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesRequest](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateplayercustompropertiesrequest.md)
- [PFPlayerDataManagementClientGetPlayerCustomPropertyRequest](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientgetplayercustompropertyrequest.md)