> ## 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 对象。可以包含版本号，用于执行乐观。

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](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*may be nullptr*

（可选）与请求关联的可选自定义标记（例如生成号、外部跟踪标识符等）。

**`customTagsCount`**   uint32\_t

customTags 的数量

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

要对其执行此操作的实体。

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

（可选）用于并发控制的可选字段。通过指定 GetProfile API 之前返回的 ProfileVersion 值，可以确保只有当自上次加载版本以来该个人资料未被任何其他客户端更新过时，才会执行对象设置操作。

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

要在个人资料上设置的对象集合。

**`objectsCount`**   uint32\_t

objects 的数量

## 要求

**头文件：** PFDataTypes.h

## 另请参阅

[PFDataTypes 成员](/services/playfab/api-references/c/pfdatatypes/pfdatatypes_members)


## Related topics

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