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

# PFDataInitiateFileUploadsRequest

> PFDataInitiateFileUploadsRequest 資料模型。傳回可在 5 分鐘內用來上傳設定檔檔案的 URL。使用上傳呼叫之後，必須呼叫 FinalizeFileUploads，以將檔案狀態從擱置中移至上線。

PFDataInitiateFileUploadsRequest 資料模型。傳回可在 5 分鐘內用來上傳設定檔檔案的 URL。使用上傳呼叫之後，必須呼叫 FinalizeFileUploads，以將檔案狀態從擱置中移至上線。

## 語法

```cpp theme={null}
typedef struct PFDataInitiateFileUploadsRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* entity;  
    const char* const* fileNames;  
    uint32_t fileNamesCount;  
    int32_t const* profileVersion;  
} PFDataInitiateFileUploadsRequest;  
```

### 成員

**`customTags`**   [PFStringDictionaryEntry](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

（選擇性）與要求相關聯的選擇性自訂標籤（例如組建編號、外部追蹤識別碼等）。

**`customTagsCount`**   uint32\_t

customTags 的計數

**`entity`**   [PFEntityKey](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfentitykey-c) const\*

要對其執行此動作的實體。

**`fileNames`**   const char\* const\*

要設定之檔案的名稱。僅限 a-Z、0-9、'('、')'、'\_'、'-' 和 '.'。

**`fileNamesCount`**   uint32\_t

fileNames 的計數

**`profileVersion`**   int32\_t const\*<br />*may be nullptr*

（選擇性）用於並行控制的選擇性欄位。透過指定先前從 GetFiles API 或其他 API 傳回的 ProfileVersion 值，您可以確保只有在您上次載入該版本後設定檔未更新的情況下，才會執行檔案上傳起始作業。如果相同實體的設定檔已更新，作業將會失敗並傳回 EntityProfileVersionMismatch 錯誤。衝突的更新可能由任何修改實體設定檔的作業所造成，包括 SetObjects、FinalizeFileUploads 和 UpdateStatistics。

## 需求

**標頭：** PFDataTypes.h

## 另請參閱

[PFDataTypes 成員](/zh-TW/services/playfab/api-references/c/pfdatatypes/pfdatatypes_members)


## Related topics

- [PFDataInitiateFileUploadsAsync](/zh-TW/services/playfab/api-references/c/pfdata/functions/pfdatainitiatefileuploadsasync.md)
- [服務 C API 概觀 - PFDataTypes.h](/zh-TW/services/playfab/api-references/c/pfdatatypes/pfdatatypes_members.md)
- [PFDataInitiateFileUploadMetadata](/zh-TW/services/playfab/api-references/c/pfdatatypes/structs/pfdatainitiatefileuploadmetadata.md)
- [PFDataInitiateFileUploadsResponse](/zh-TW/services/playfab/api-references/c/pfdatatypes/structs/pfdatainitiatefileuploadsresponse.md)
- [PFDataInitiateFileUploadsGetResult](/zh-TW/services/playfab/api-references/c/pfdata/functions/pfdatainitiatefileuploadsgetresult.md)