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

# PFItemInstance

> PFItemInstance 数据模型。用户库存中项目的唯一实例。注意，若要检索项目的其他信息（如标签、描述），需要调用 GetCatalogItems。

PFItemInstance 数据模型。用户库存中项目的唯一实例。注意，若要检索项目的其他信息（如项目的所有实例都相同的标签、描述），需要调用 GetCatalogItems。ItemID 可以与目录条目匹配，其中包含其他信息。另请注意，仅当用户的特定实例通过调用 UpdateUserInventoryItemCustomData 更新 CustomData 时，才会设置 Custom Data。其他字段（如 UnitPrice 和 UnitCurrency）仅在通过购买授予项目时设置。

## 语法

```cpp theme={null}
typedef struct PFItemInstance {  
    const char* annotation;  
    const char* const* bundleContents;  
    uint32_t bundleContentsCount;  
    const char* bundleParent;  
    const char* catalogVersion;  
    PFStringDictionaryEntry const* customData;  
    uint32_t customDataCount;  
    const char* displayName;  
    time_t const* expiration;  
    const char* itemClass;  
    const char* itemId;  
    const char* itemInstanceId;  
    time_t const* purchaseDate;  
    int32_t const* remainingUses;  
    const char* unitCurrency;  
    uint32_t unitPrice;  
    int32_t const* usesIncrementedBy;  
} PFItemInstance;  
```

### 成员

**`annotation`**   const char\*<br />*is null-terminated*

（可选）将此实例添加到用户库存时与此实例关联的游戏特定注释。

**`bundleContents`**   const char\* const\*<br />*may be nullptr*

（可选）购买此目录项目时授予的唯一项目数组。

**`bundleContentsCount`**   uint32\_t

bundleContents 的计数

**`bundleParent`**   const char\*<br />*is null-terminated*

（可选）父库存项目的唯一标识符，如目录中所定义，用于从捆绑包或容器中添加的对象。

**`catalogVersion`**   const char\*<br />*is null-terminated*

（可选）创建此实例时库存项目的目录版本。

**`customData`**   PFStringDictionaryEntry const\*<br />*may be nullptr*

（可选）库存项目实例上的一组自定义键值对，不要与目录项目的自定义数据混淆。

**`customDataCount`**   uint32\_t

customData 的计数

**`displayName`**   const char\*<br />*is null-terminated*

（可选）购买此项目时的 CatalogItem.DisplayName。

**`expiration`**   time\_t const\*<br />*may be nullptr*

（可选）此实例将到期的时间戳。

**`itemClass`**   const char\*<br />*is null-terminated*

（可选）库存项目的类名，如目录中所定义。

**`itemId`**   const char\*<br />*is null-terminated*

（可选）库存项目的唯一标识符，如目录中所定义。

**`itemInstanceId`**   const char\*<br />*is null-terminated*

（可选）此项目特定实例的唯一项目标识符。

**`purchaseDate`**   time\_t const\*<br />*may be nullptr*

（可选）购买此实例的时间戳。

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

（可选）剩余使用次数总数（如果这是一个消耗品）。

**`unitCurrency`**   const char\*<br />*is null-terminated*

（可选）目录项目成本的货币类型。授予项目时不可用。

**`unitPrice`**   uint32\_t

给定货币中目录项目的成本。授予项目时不可用。

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

（可选）在此调用中添加或移除到此项目的使用次数。

## 要求

**头文件：** PFTypes.h

## 另请参阅

[PFTypes 成员](/services/playfab/api-references/c/pftypes/pftypes_members)


## Related topics

- [PFCharacterInventory](/zh-CN/services/playfab/api-references/c/pftypes/structs/pfcharacterinventory.md)
- [服务 C API 概览 - PFTypes.h](/zh-CN/services/playfab/api-references/c/pftypes/pftypes_members.md)
- [PFGetPlayerCombinedInfoResultPayload](/zh-CN/services/playfab/api-references/c/pftypes/structs/pfgetplayercombinedinforesultpayload.md)
- [CartItem](/zh-CN/services/playfab/api-references/events/data-types/cartitem.md)
- [character_consumed_item](/zh-CN/services/playfab/api-references/events/Character/character-consumed-item.md)