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

> Modelo de datos de PFItemInstance. Instancia única de un artículo en el inventario de un usuario. Tenga en cuenta que, para recuperar información adicional de un artículo, como Tags o Description.

Modelo de datos de PFItemInstance. Instancia única de un artículo en el inventario de un usuario. Tenga en cuenta que, para recuperar información adicional de un artículo, como Tags o Description, que es la misma en todas las instancias del artículo, se requiere una llamada a GetCatalogItems. El ItemID se puede hacer coincidir con una entrada del catálogo, que contiene la información adicional. Tenga en cuenta también que los datos personalizados (Custom Data) solo se establecen cuando la instancia específica del usuario ha actualizado CustomData mediante una llamada a UpdateUserInventoryItemCustomData. Otros campos, como UnitPrice y UnitCurrency, solo se establecen cuando el artículo se concedió mediante una compra.

## Sintaxis

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

### Miembros

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

(Opcional) Comentario específico del juego asociado a esta instancia cuando se agregó al inventario del usuario.

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

(Opcional) Matriz de artículos únicos que se otorgaron cuando se compró este artículo del catálogo.

**`bundleContentsCount`**   uint32\_t

Recuento de bundleContents

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

(Opcional) Identificador único del artículo de inventario principal, tal como se define en el catálogo, para los objetos que se agregaron desde un lote o contenedor.

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

(Opcional) Versión del catálogo del artículo de inventario en el momento en que se creó esta instancia.

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

(Opcional) Conjunto de pares clave-valor personalizados de la instancia del artículo de inventario, que no debe confundirse con los datos personalizados del artículo del catálogo.

**`customDataCount`**   uint32\_t

Recuento de customData

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

(Opcional) CatalogItem.DisplayName en el momento en que se compró este artículo.

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

(Opcional) Marca de tiempo que indica cuándo expirará esta instancia.

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

(Opcional) Nombre de clase del artículo de inventario, tal como se define en el catálogo.

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

(Opcional) Identificador único del artículo de inventario, tal como se define en el catálogo.

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

(Opcional) Identificador de artículo único de esta instancia específica del artículo.

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

(Opcional) Marca de tiempo que indica cuándo se compró esta instancia.

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

(Opcional) Número total de usos restantes, si se trata de un artículo consumible.

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

(Opcional) Tipo de moneda del costo del artículo del catálogo. No está disponible al conceder artículos.

**`unitPrice`**   uint32\_t

Costo del artículo del catálogo en la moneda indicada. No está disponible al conceder artículos.

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

(Opcional) Número de usos que se agregaron o quitaron a este artículo en esta llamada.

## Requisitos

**Encabezado:** PFTypes.h

## Consulte también

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


## Related topics

- [PFCharacterInventory](/es/services/playfab/api-references/c/pftypes/structs/pfcharacterinventory.md)
- [Información general de la API de C de Services - PFTypes.h](/es/services/playfab/api-references/c/pftypes/pftypes_members.md)
- [PFGetPlayerCombinedInfoResultPayload](/es/services/playfab/api-references/c/pftypes/structs/pfgetplayercombinedinforesultpayload.md)
- [CartItem](/es/services/playfab/api-references/events/data-types/cartitem.md)
- [player_consumed_item](/es/services/playfab/api-references/events/Player/player-consumed-item.md)