> ## 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 資料模型。使用者庫存中項目的唯一執行個體。請注意，若要擷取項目的其他資訊，例如 Tags、Description。

PFItemInstance 資料模型。使用者庫存中項目的唯一執行個體。請注意，若要擷取項目在所有執行個體間都相同的其他資訊 (例如 Tags、Description)，必須呼叫 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\*\
*is null-terminated*

（選擇性）此執行個體新增至使用者庫存時，與其相關聯的遊戲專屬註解。

**`bundleContents`**   const char\* const\*\
*may be nullptr*

（選擇性）購買此目錄項目時所獎勵的唯一項目陣列。

**`bundleContentsCount`**   uint32\_t

bundleContents 的計數

**`bundleParent`**   const char\*\
*is null-terminated*

（選擇性）對於從組合或容器新增的物件，其父庫存項目的唯一識別碼 (如目錄中所定義)。

**`catalogVersion`**   const char\*\
*is null-terminated*

（選擇性）建立此執行個體時，庫存項目的目錄版本。

**`customData`**   PFStringDictionaryEntry const\*\
*may be nullptr*

（選擇性）庫存項目執行個體上的一組自訂索引鍵/值組，請勿與目錄項目的自訂資料混淆。

**`customDataCount`**   uint32\_t

customData 的計數

**`displayName`**   const char\*\
*is null-terminated*

（選擇性）購買此項目時的 CatalogItem.DisplayName。

**`expiration`**   time\_t const\*\
*may be nullptr*

（選擇性）此執行個體到期時間的時間戳記。

**`itemClass`**   const char\*\
*is null-terminated*

（選擇性）庫存項目的類別名稱 (如目錄中所定義)。

**`itemId`**   const char\*\
*is null-terminated*

（選擇性）庫存項目的唯一識別碼 (如目錄中所定義)。

**`itemInstanceId`**   const char\*\
*is null-terminated*

（選擇性）此項目特定執行個體的唯一項目識別碼。

**`purchaseDate`**   time\_t const\*\
*may be nullptr*

（選擇性）購買此執行個體時間的時間戳記。

**`remainingUses`**   int32\_t const\*\
*may be nullptr*

（選擇性）如果這是消耗性項目，則為剩餘使用次數總計。

**`unitCurrency`**   const char\*\
*is null-terminated*

（選擇性）目錄項目成本的貨幣類型。授與項目時無法使用。

**`unitPrice`**   uint32\_t

以指定貨幣表示的目錄項目成本。授與項目時無法使用。

**`usesIncrementedBy`**   int32\_t const\*\
*may be nullptr*

（選擇性）此呼叫中對此項目新增或移除的使用次數。

## 需求

**標頭:** PFTypes.h

## 另請參閱

[PFTypes 成員](/zh-TW/services/playfab/api-references/c/pftypes/pftypes_members)


## Related topics

- [PFCharacterInventory](/zh-TW/services/playfab/api-references/c/pftypes/structs/pfcharacterinventory.md)
- [Unlock Container Instance](/api-reference/player-item-management/unlock-container-instance.md)
- [Purchase Item](/api-reference/player-item-management/purchase-item.md)
- [Consume Item](/api-reference/player-item-management/consume-item.md)
- [Unlock Container Item](/api-reference/player-item-management/unlock-container-item.md)