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

# PFDataInitiateFileUploadsAsync

> 엔터티의 프로필로의 파일 업로드를 시작합니다.

엔터티의 프로필로의 파일 업로드를 시작합니다.

## 구문

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

### 매개 변수

**`entityHandle`**   PFEntityHandle

인증에 사용할 PFEntityHandle입니다.

**`request`**   [PFDataInitiateFileUploadsRequest\*](/services/playfab/api-references/c/pfdatatypes/structs/pfdatainitiatefileuploadsrequest)

채워진 요청 개체입니다.

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

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

### 반환 값

형식: HRESULT

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

## 설명

이 API는 모든 플랫폼에서 사용할 수 있습니다. 5분 동안 프로필의 파일을 업로드하는 데 사용할 수 있는 URL을 반환합니다. 업로드 호출을 사용한 후에는 FinalizeFileUploads를 호출하여 파일 상태를 pending에서 live로 이동해야 합니다. FileAbortFileUploadsAsync, FileDeleteFilesAsync, FileFinalizeFileUploadsAsync, FileGetFilesAsync도 참조하세요. 비동기 작업이 완료되면 [PFDataInitiateFileUploadsGetResultSize](/services/playfab/api-references/c/pfdata/functions/pfdatainitiatefileuploadsgetresultsize) 및 [PFDataInitiateFileUploadsGetResult](/services/playfab/api-references/c/pfdata/functions/pfdatainitiatefileuploadsgetresult)를 호출하여 결과를 가져옵니다.

## 요구 사항

**헤더:** PFData.h

## 참고 항목

[PFData 멤버](/services/playfab/api-references/c/pfdata/pfdata_members)


## Related topics

- [PFDataInitiateFileUploadsGetResult](/ko/services/playfab/api-references/c/pfdata/functions/pfdatainitiatefileuploadsgetresult.md)
- [Services C API 개요 - PFData.h](/ko/services/playfab/api-references/c/pfdata/pfdata_members.md)
- [PFDataInitiateFileUploadsResponse](/ko/services/playfab/api-references/c/pfdatatypes/structs/pfdatainitiatefileuploadsresponse.md)
- [PFDataInitiateFileUploadMetadata](/ko/services/playfab/api-references/c/pfdatatypes/structs/pfdatainitiatefileuploadmetadata.md)
- [PFDataInitiateFileUploadsRequest](/ko/services/playfab/api-references/c/pfdatatypes/structs/pfdatainitiatefileuploadsrequest.md)