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

# PFTitleDataManagementServerSetTitleDataAsync

> 클라이언트에 표시되는 사용자 지정 타이틀 설정의 키-값 저장소를 업데이트하는 서버 API로, 신뢰할 수 있는 게임 서버에서 호출하여 타이틀 범위 구성을 변경할 수 있습니다.

사용자 지정 타이틀 설정의 키-값 저장소를 업데이트합니다.

## 구문

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

### 매개 변수

**`titleEntityHandle`**   PFEntityHandle

PFAuthenticationGetEntityWithSecretKeyAsync를 사용하여 얻은 타이틀 엔터티의 PFEntityHandle입니다.

**`request`**   [PFTitleDataManagementSetTitleDataRequest\*](/services/playfab/api-references/c/pftitledatamanagementtypes/structs/pftitledatamanagementsettitledatarequest)

값이 채워진 요청 객체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 API는 Win32, Linux 및 macOS에서 사용할 수 있습니다. 이 API는 클라이언트가 읽을 수는 있지만 쓸 수는 없는 타이틀별 값을 저장하도록 설계되었습니다. 예를 들어, 개발자는 적 스폰 비율, 무기 강도, 이동 속도 등과 같이 사용자 환경을 수정하는 값을 저장하도록 선택할 수 있습니다. 이렇게 하면 개발자는 새 빌드를 만들고 테스트하고 배포할 필요 없이 타이틀을 업데이트할 수 있습니다. 이 작업은 추가 방식입니다. 현재 데이터 세트에 키가 존재하지 않는 경우 지정된 값과 함께 추가됩니다. 이미 존재하는 경우 해당 키의 값이 새 값으로 덮어써집니다. ServerGetTitleDataAsync도 참조하세요. 작업 상태를 얻으려면 XAsyncGetStatus를 호출하세요. 서비스 호출이 실패한 경우, 비동기 결과는 E\_PF\_DATA\_LENGTH\_EXCEEDED, E\_PF\_TOO\_MANY\_KEYS 또는 전역 PlayFab 서비스 오류 중 하나가 됩니다. 오류 처리에 대한 자세한 내용은 “Handling PlayFab Errors” 문서 페이지를 참조하세요.

## 요구 사항

**헤더:** PFTitleDataManagement.h

## 참고 항목

[PFTitleDataManagement 멤버](/services/playfab/api-references/c/pftitledatamanagement/pftitledatamanagement_members)


## Related topics

- [Services C API 개요 - PFTitleDataManagement.h](/ko/services/playfab/api-references/c/pftitledatamanagement/pftitledatamanagement_members.md)
- [PFTitleDataManagementServerSetTitleInternalDataAsync](/ko/services/playfab/api-references/c/pftitledatamanagement/functions/pftitledatamanagementserversettitleinternaldataasync.md)
- [PFTitleDataManagementServerSetPublisherDataAsync](/ko/services/playfab/api-references/c/pftitledatamanagement/functions/pftitledatamanagementserversetpublisherdataasync.md)
- [PFTitleDataManagementServerGetTitleDataAsync](/ko/services/playfab/api-references/c/pftitledatamanagement/functions/pftitledatamanagementservergettitledataasync.md)
- [PFTitleDataManagementServerGetTitleInternalDataAsync](/ko/services/playfab/api-references/c/pftitledatamanagement/functions/pftitledatamanagementservergettitleinternaldataasync.md)