> ## 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. Une instance unique d'un article dans l'inventaire d'un utilisateur. Notez que pour récupérer des informations supplémentaires sur un article, comme les balises (Tags) et la description (Description).

Modèle de données PFItemInstance. Une instance unique d'un article dans l'inventaire d'un utilisateur. Notez que pour récupérer des informations supplémentaires sur un article, comme les balises (Tags) et la description (Description), qui sont identiques pour toutes les instances de l'article, un appel à GetCatalogItems est requis. L'ItemID peut être associé à une entrée de catalogue, qui contient les informations supplémentaires. Notez également que les données personnalisées (Custom Data) ne sont définies que lorsque l'instance propre à l'utilisateur a mis à jour CustomData au moyen d'un appel à UpdateUserInventoryItemCustomData. D'autres champs, comme UnitPrice et UnitCurrency, ne sont définis que lorsque l'article a été accordé au moyen d'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\*\
*se termine par un caractère nul*

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

**`bundleContents`**   const char\* const\*\
*peut être nullptr*

(Facultatif) Tableau des articles uniques qui ont été attribués lors de l'achat de cet article de catalogue.

**`bundleContentsCount`**   uint32\_t

Nombre de bundleContents

**`bundleParent`**   const char\*\
*se termine par un caractère nul*

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

**`catalogVersion`**   const char\*\
*se termine par un caractère nul*

(Facultatif) Version du catalogue de l'article d'inventaire, au moment où cette instance a été créée.

**`customData`**   PFStringDictionaryEntry const\*\
*peut être nullptr*

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

**`customDataCount`**   uint32\_t

Nombre de customData

**`displayName`**   const char\*\
*se termine par un caractère nul*

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

**`expiration`**   time\_t const\*\
*peut être nullptr*

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

**`itemClass`**   const char\*\
*se termine par un caractère nul*

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

**`itemId`**   const char\*\
*se termine par un caractère nul*

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

**`itemInstanceId`**   const char\*\
*se termine par un caractère nul*

(Facultatif) Identificateur d'article unique pour cette instance précise de l'article.

**`purchaseDate`**   time\_t const\*\
*peut être nullptr*

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

**`remainingUses`**   int32\_t const\*\
*peut être nullptr*

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

**`unitCurrency`**   const char\*\
*se termine par un caractère nul*

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

**`unitPrice`**   uint32\_t

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

**`usesIncrementedBy`**   int32\_t const\*\
*peut être nullptr*

(Facultatif) Le nombre d'utilisations ajoutées à cet article ou retirées de celui-ci lors de cet appel.

## Configuration requise

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

## Voir aussi

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


## Related topics

- [PFCharacterInventory](/fr-CA/services/playfab/api-references/c/pftypes/structs/pfcharacterinventory.md)
- [Vue d'ensemble de l'API C Services - PFTypes.h](/fr-CA/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-CA/services/playfab/api-references/rest/server/player-item-management/unlock-container-instance.md)
- [Purchase Item](/api-reference/player-item-management/purchase-item.md)