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

> Modèle de données PFItemInstance. Instance unique d'un élément dans l'inventaire d'un utilisateur. Remarque : pour récupérer des informations supplémentaires sur un élément, comme Tags, Description.

Modèle de données PFItemInstance. Instance unique d'un élément dans l'inventaire d'un utilisateur. Remarque : pour récupérer des informations supplémentaires sur un élément, comme Tags et Description, qui sont identiques pour toutes les instances de l'élément, un appel à GetCatalogItems est nécessaire. L'ItemID peut être mis en correspondance avec une entrée de catalogue, qui contient les informations supplémentaires. Notez également que Custom Data n'est défini que lorsque l'instance propre à l'utilisateur a mis à jour CustomData via un appel à UpdateUserInventoryItemCustomData. D'autres champs, tels que UnitPrice et UnitCurrency, ne sont définis que lorsque l'élément a été accordé via un achat.

## Syntaxe

```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;  
```

### Membres

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

(Facultatif) Commentaire propre au jeu associé à cette instance lorsqu'elle a été ajoutée à l'inventaire de l'utilisateur.

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

(Facultatif) Tableau des éléments uniques attribués lors de l'achat de cet élément de catalogue.

**`bundleContentsCount`**   uint32\_t

Nombre de bundleContents

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

(Facultatif) Identificateur unique de l'élément d'inventaire parent, tel que défini dans le catalogue, pour les objets ajoutés à partir d'un pack ou d'un conteneur.

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

(Facultatif) Version du catalogue de l'élément d'inventaire, au moment de la création de cette instance.

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

(Facultatif) Ensemble de paires clé-valeur personnalisées sur l'instance de l'élément d'inventaire, à ne pas confondre avec les données personnalisées de l'élément de catalogue.

**`customDataCount`**   uint32\_t

Nombre de customData

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

(Facultatif) CatalogItem.DisplayName au moment de l'achat de cet élément.

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

(Facultatif) Horodatage de l'expiration de cette instance.

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

(Facultatif) Nom de classe de l'élément d'inventaire, tel que défini dans le catalogue.

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

(Facultatif) Identificateur unique de l'élément d'inventaire, tel que défini dans le catalogue.

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

(Facultatif) Identificateur d'élément unique pour cette instance spécifique de l'élément.

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

(Facultatif) Horodatage de l'achat de cette instance.

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

(Facultatif) Nombre total d'utilisations restantes, s'il s'agit d'un élément consommable.

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

(Facultatif) Type de monnaie pour le coût de l'élément de catalogue. Non disponible lors de l'octroi d'éléments.

**`unitPrice`**   uint32\_t

Coût de l'élément de catalogue dans la monnaie donnée. Non disponible lors de l'octroi d'éléments.

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

(Facultatif) Nombre d'utilisations ajoutées à cet élément ou retirées de celui-ci lors de cet appel.

## Configuration requise

**En-tête :** PFTypes.h

## Voir aussi

[Membres de PFTypes](/fr/services/playfab/api-references/c/pftypes/pftypes_members)


## Related topics

- [PFCharacterInventory](/fr/services/playfab/api-references/c/pftypes/structs/pfcharacterinventory.md)
- [Vue d'ensemble de l'API C Services - PFTypes.h](/fr/services/playfab/api-references/c/pftypes/pftypes_members.md)
- [Unlock Container Instance](/api-reference/player-item-management/unlock-container-instance.md)
- [Déverrouiller une instance de conteneur](/fr/services/playfab/api-references/rest/server/player-item-management/unlock-container-instance.md)
- [Purchase Item](/api-reference/player-item-management/purchase-item.md)