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

# PFPlayerDataManagementClientUpdatePlayerCustomPropertiesAsync

> 플레이어의 사용자 지정 속성에 대해 추가 업데이트를 수행하는 Client API입니다. 기존 속성은 덮어쓰고, 지정되지 않은 속성은 변경되지 않습니다.

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

## 구문

```cpp theme={null}
HRESULT PFPlayerDataManagementClientUpdatePlayerCustomPropertiesAsync(  
    PFEntityHandle entityHandle,  
    const PFPlayerDataManagementClientUpdatePlayerCustomPropertiesRequest* request,  
    XAsyncBlock* async  
)  
```

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

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

채워진 요청 개체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. 지정된 플레이어의 사용자 지정 속성에 대해 추가 업데이트를 수행합니다. 플레이어의 사용자 지정 속성을 업데이트할 때 이미 존재하는 속성은 값을 덮어씁니다. 호출에서 지정한 속성 외에는 다른 속성이 변경되지 않습니다. ClientDeletePlayerCustomPropertiesAsync, ClientGetPlayerCustomPropertyAsync, ClientListPlayerCustomPropertiesAsync도 참조하세요. 비동기 작업이 완료되면 [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesGetResult](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesgetresult)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFPlayerDataManagement.h

## 참고 항목

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


## Related topics

- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesGetResult](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateplayercustompropertiesgetresult.md)
- [PFPlayerDataManagementClientGetPlayerCustomPropertyAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientgetplayercustompropertyasync.md)
- [PFPlayerDataManagementClientListPlayerCustomPropertiesAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientlistplayercustompropertiesasync.md)
- [PFPlayerDataManagementClientDeletePlayerCustomPropertiesAsync](/ko/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientdeleteplayercustompropertiesasync.md)
- [PFPlayerDataManagementClientUpdatePlayerCustomPropertiesResult](/ko/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementclientupdateplayercustompropertiesresult.md)