> ## 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 データ モデル。ユーザーのインベントリ内のアイテムの一意のインスタンス。タグや説明などの追加情報を取得するには。

PFItemInstance データ モデル。ユーザーのインベントリ内のアイテムの一意のインスタンス。アイテムのすべてのインスタンスで共通のタグや説明などの追加情報を取得するには、GetCatalogItems の呼び出しが必要です。ItemID をカタログ エントリと突き合わせることで、追加情報を得られます。また、Custom Data は、UpdateUserInventoryItemCustomData を呼び出してユーザー固有のインスタンスの CustomData を更新した場合にのみ設定されます。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](/ja-jp/services/playfab/api-references/c/pftypes/structs/pfcharacterinventory.md)
- [Services C API overview - PFTypes.h](/ja-jp/services/playfab/api-references/c/pftypes/pftypes_members.md)
- [PFGetPlayerCombinedInfoResultPayload](/ja-jp/services/playfab/api-references/c/pftypes/structs/pfgetplayercombinedinforesultpayload.md)
- [CartItem](/ja-jp/services/playfab/api-references/events/data-types/cartitem.md)
- [character_consumed_item](/ja-jp/services/playfab/api-references/events/Character/character-consumed-item.md)