Passer au contenu principal
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

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
Dernière modification le 6 octobre 2026