> ## 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 dados de PFItemInstance. Uma instância exclusiva de um item no inventário de um usuário. Observação: para recuperar informações adicionais de um item, como Tags e Description.

Modelo de dados de PFItemInstance. Uma instância exclusiva de um item no inventário de um usuário. Observação: para recuperar informações adicionais de um item, como Tags e Description, que são iguais em todas as instâncias do item, é necessária uma chamada para GetCatalogItems. O ItemID pode ser correspondido a uma entrada do catálogo, que contém as informações adicionais. Observe também que Custom Data só é definido quando a instância específica do usuário atualizou o CustomData por meio de uma chamada para UpdateUserInventoryItemCustomData. Outros campos, como UnitPrice e UnitCurrency, só são definidos quando o item foi concedido por meio de uma compra.

## Sintaxe

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

### Membros

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

(Opcional) Comentário específico do jogo associado a esta instância quando ela foi adicionada ao inventário do usuário.

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

(Opcional) Matriz de itens exclusivos concedidos quando este item do catálogo foi comprado.

**`bundleContentsCount`**   uint32\_t

Contagem de bundleContents

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

(Opcional) Identificador exclusivo do item de inventário pai, conforme definido no catálogo, para objetos adicionados de um pacote ou contêiner.

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

(Opcional) Versão do catálogo do item de inventário, quando esta instância foi criada.

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

(Opcional) Um conjunto de pares chave-valor personalizados na instância do item de inventário, que não deve ser confundido com os dados personalizados do item do catálogo.

**`customDataCount`**   uint32\_t

Contagem de customData

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

(Opcional) CatalogItem.DisplayName no momento em que este item foi comprado.

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

(Opcional) Carimbo de data/hora de quando esta instância expirará.

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

(Opcional) Nome da classe do item de inventário, conforme definido no catálogo.

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

(Opcional) Identificador exclusivo do item de inventário, conforme definido no catálogo.

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

(Opcional) Identificador exclusivo do item para esta instância específica do item.

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

(Opcional) Carimbo de data/hora de quando esta instância foi comprada.

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

(Opcional) Número total de usos restantes, se este for um item consumível.

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

(Opcional) Tipo de moeda do custo do item do catálogo. Não disponível ao conceder itens.

**`unitPrice`**   uint32\_t

Custo do item do catálogo na moeda especificada. Não disponível ao conceder itens.

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

(Opcional) O número de usos adicionados ou removidos deste item nesta chamada.

## Requisitos

**Cabeçalho:** PFTypes.h

## Confira também

[Membros de PFTypes](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pftypes/pftypes_members.md)


## Related topics

- [PFCharacterInventory](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/c/pftypes/structs/pfcharacterinventory.md)
- [Unlock Container Instance](https://devdocs.xbox.com/api-reference/player-item-management/unlock-container-instance.md)
- [Comprar item](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/rest/client/player-item-management/purchase-item.md)
- [Purchase Item](https://devdocs.xbox.com/api-reference/player-item-management/purchase-item.md)
- [Consumir item](https://devdocs.xbox.com/pt-BR/services/playfab/api-references/rest/client/player-item-management/consume-item.md)