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

# PFPlayerDataManagementServerUpdatePlayerCustomPropertiesAsync

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

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

## 구문

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

### 매개 변수

**`titleEntityHandle`**   PFEntityHandle

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

**`request`**   [PFPlayerDataManagementServerUpdatePlayerCustomPropertiesRequest\*](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateplayercustompropertiesrequest)

채워진 요청 개체입니다.

**`async`**   XAsyncBlock\*<br />*Inout*

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

### 반환 값

형식: HRESULT

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

## 설명

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

## 요구 사항

**헤더:** PFPlayerDataManagement.h

## 참고 항목

[PFPlayerDataManagement 멤버](/ko/services/playfab/api-references/c/pfplayerdatamanagement/pfplayerdatamanagement_members)


## Related topics

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