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

# PFPlayerDataManagementClientUpdateUserDataRequest

> PFPlayerDataManagementClientUpdateUserDataRequest 数据模型。此函数对包含自定义数据的任意字符串执行增量更新。

PFPlayerDataManagementClientUpdateUserDataRequest 数据模型。此函数对包含用户自定义数据的任意字符串执行增量更新。在更新自定义数据对象时，对象中已存在的键的值将被覆盖，而具有 null 值的键将被删除。新键将使用给定值添加。除调用中指定的键值对外，其他键值对不会更改。

## 语法

```cpp theme={null}
typedef struct PFPlayerDataManagementClientUpdateUserDataRequest {  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFStringDictionaryEntry const* data;  
    uint32_t dataCount;  
    const char* const* keysToRemove;  
    uint32_t keysToRemoveCount;  
    PFUserDataPermission const* permission;  
} PFPlayerDataManagementClientUpdateUserDataRequest;  
```

### 成员

**`customTags`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*可以为 nullptr*

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

**`customTagsCount`**   uint32\_t

customTags 的计数

**`data`**   [PFStringDictionaryEntry](/services/playfab/api-references/c/pftypes/structs/pfstringdictionaryentry) const\*<br />*可以为 nullptr*

（可选）要写入自定义数据的键值对。请注意，键会被去除空白、大小受限，并且不能以 "!" 字符开头或为 null。

**`dataCount`**   uint32\_t

data 的计数

**`keysToRemove`**   const char\* const\*<br />*可以为 nullptr*

（可选）要从 UserData 中移除的 Data 键的可选列表。由于语言约束，某些 SDK 无法将 null 值插入 Data。使用此参数可直接删除键。

**`keysToRemoveCount`**   uint32\_t

keysToRemove 的计数

**`permission`**   [PFUserDataPermission](/services/playfab/api-references/c/pftypes/enums/pfuserdatapermission) const\*<br />*可以为 nullptr*

（可选）应用于此请求中写入的所有用户数据键的权限。如果未设置，则默认为 "private"。用于一个玩家请求另一个玩家信息的情况；这些请求仅返回 Public 键。

## 要求

**头文件：** PFPlayerDataManagementTypes.h

## 另请参阅

[PFPlayerDataManagementTypes 成员](/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members)


## Related topics

- [PFPlayerDataManagementClientUpdateUserDataAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserdataasync.md)
- [PFPlayerDataManagementClientUpdateUserPublisherDataAsync](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagement/functions/pfplayerdatamanagementclientupdateuserpublisherdataasync.md)
- [服务 C API 概览 - PFPlayerDataManagementTypes.h](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagementtypes/pfplayerdatamanagementtypes_members.md)
- [PFPlayerDataManagementServerUpdateUserDataRequest](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementserverupdateuserdatarequest.md)
- [PFPlayerDataManagementUpdateUserInternalDataRequest](/zh-CN/services/playfab/api-references/c/pfplayerdatamanagementtypes/structs/pfplayerdatamanagementupdateuserinternaldatarequest.md)