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

# PFDataSetObjectsRequest

> PFDataSetObjectsRequest 資料模型。在所要求的實體設定檔上設定 JSON 物件。可包含版本號碼，用於在更新期間執行開放式並行作業。如果目前版本與要求中的版本不同，將會忽略要求。如果要求未設定版本，則只要值不同就一律會更新值。不過，使用版本值並不保證會寫入；如果多個用戶端嘗試更新相同的設定檔，仍可能發生 ConcurrentEditError。

PFDataSetObjectsRequest 資料模型。在所要求的實體設定檔上設定 JSON 物件。可包含版本號碼，用於在更新期間執行開放式並行作業。如果目前版本與要求中的版本不同，將會忽略要求。如果要求未設定版本，則只要值不同就一律會更新值。不過，使用版本值並不保證會寫入；如果多個用戶端嘗試更新相同的設定檔，仍可能發生 ConcurrentEditError。

## 語法

```cpp theme={null}
typedef struct PFDataSetObjectsRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFEntityKey const* entity;  
    int32_t const* expectedProfileVersion;  
    PFDataSetObject const* objects;  
    uint32_t objectsCount;  
} PFDataSetObjectsRequest;  
```

### 成員

**`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\*

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

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

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

**`objects`**   [PFDataSetObject](/zh-TW/services/playfab/api-references/c/pfdatatypes/structs/pfdatasetobject) const\*

要在設定檔上設定的物件集合。

**`objectsCount`**   uint32\_t

objects 的計數

## 需求

**標頭：** PFDataTypes.h

## 另請參閱

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


## Related topics

- [PFDataSetObjectsAsync](/zh-TW/services/playfab/api-references/c/pfdata/functions/pfdatasetobjectsasync.md)
- [服務 C API 概觀 - PFDataTypes.h](/zh-TW/services/playfab/api-references/c/pfdatatypes/pfdatatypes_members.md)
- [PFDataSetObject](/zh-TW/services/playfab/api-references/c/pfdatatypes/structs/pfdatasetobject.md)
- [PFDataGetObjectsRequest](/zh-TW/services/playfab/api-references/c/pfdatatypes/structs/pfdatagetobjectsrequest.md)
- [PFDataSetObjectInfo](/zh-TW/services/playfab/api-references/c/pfdatatypes/structs/pfdatasetobjectinfo.md)