> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PFPlayerDataManagementServerUpdatePlayerCustomPropertiesAsync

> 타이틀 엔터티 핸들을 사용하여 플레이어의 사용자 지정 속성을 가산적으로 업데이트하는 Server API입니다. 기존 값은 덮어써집니다. Windows에서 사용할 수 있습니다.

플레이어의 타이틀별 사용자 지정 속성 값을 업데이트합니다.

## 구문

```cpp theme={null}
HRESULT PFPlayerDataManagementServerUpdatePlayerCustomPropertiesAsync(  
    PFEntityHandle titleEntityHandle,  
    const PFPlayerDataManagementServerUpdatePlayerCustomPropertiesRequest* request,  
    XAsyncBlock* async  
)  
```

### 매개 변수

**`titleEntityHandle`**   PFEntityHandle

PFAuthenticationGetEntityWithSecretKeyAsync를 사용하여 가져온 타이틀 엔터티의 PFEntityHandle입니다.

**`request`**   [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesRequest\*](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateplayercustompropertiesrequest.md)

채워진 요청 개체입니다.

**`async`**   XAsyncBlock\*\
*Inout*

비동기 작업을 위한 XAsyncBlock입니다.

### 반환 값

형식: HRESULT

이 API 작업의 결과 코드입니다.

## 설명

이 API는 Windows에서 사용할 수 있습니다. 지정된 플레이어의 사용자 지정 속성에 대해 가산적 업데이트를 수행합니다. 플레이어의 사용자 지정 속성을 업데이트할 때 이미 존재하는 속성은 값이 덮어써집니다. 호출에서 지정한 속성 외의 다른 속성은 변경되지 않습니다. ServerDeletePlayerCustomPropertiesAsync, ServerGetPlayerCustomPropertyAsync, ServerListPlayerCustomPropertiesAsync도 참조하세요. 비동기 작업이 완료되면 [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesGetResultSize](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateplayercustompropertiesgetresultsize.md) 및 [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesGetResult](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateplayercustompropertiesgetresult.md)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFPlayerDataManagement.h

## 참고 항목

[PFPlayerDataManagement 멤버](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members.md)


## Related topics

- [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesGetResult](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverupdateplayercustompropertiesgetresult.md)
- [PFPlayerDataManagementServerListPlayerCustomPropertiesAsync](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverlistplayercustompropertiesasync.md)
- [PFPlayerDataManagementServerGetPlayerCustomPropertyAsync](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementservergetplayercustompropertyasync.md)
- [PFPlayerDataManagementServerDeletePlayerCustomPropertiesAsync](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementserverdeleteplayercustompropertiesasync.md)
- [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesResult](https://docs.xbox.com/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateplayercustompropertiesresult.md)