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

> PFItemInstance 데이터 모델입니다. 사용자의 인벤토리에 있는 항목의 고유 인스턴스입니다. 항목의 Tags, Description과 같은 추가 정보를 검색하는 방법에 대한 참고 사항입니다.

PFItemInstance 데이터 모델입니다. 사용자의 인벤토리에 있는 항목의 고유 인스턴스입니다. 항목의 모든 인스턴스에서 동일한 Tags, Description과 같은 추가 정보를 검색하려면 GetCatalogItems를 호출해야 합니다. ItemID를 카탈로그 항목과 매칭할 수 있으며, 여기에 추가 정보가 포함되어 있습니다. 또한, Custom Data는 사용자의 특정 인스턴스가 UpdateUserInventoryItemCustomData 호출을 통해 CustomData를 업데이트한 경우에만 설정됩니다. UnitPrice 및 UnitCurrency와 같은 다른 필드는 항목이 구매를 통해 부여된 경우에만 설정됩니다.

## 구문

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

### 멤버

**`annotation`**   const char\*\
*null로 종료됨*

(선택 사항) 이 인스턴스가 사용자 인벤토리에 추가될 때 연결된 게임별 코멘트입니다.

**`bundleContents`**   const char\* const\*\
*nullptr일 수 있음*

(선택 사항) 이 카탈로그 항목이 구매될 때 부여된 고유 항목의 배열입니다.

**`bundleContentsCount`**   uint32\_t

bundleContents의 개수

**`bundleParent`**   const char\*\
*null로 종료됨*

(선택 사항) 번들 또는 컨테이너에서 추가된 개체의 경우, 카탈로그에 정의된 상위 인벤토리 항목의 고유 식별자입니다.

**`catalogVersion`**   const char\*\
*null로 종료됨*

(선택 사항) 이 인스턴스가 생성될 때의 인벤토리 항목에 대한 카탈로그 버전입니다.

**`customData`**   PFStringDictionaryEntry const\*\
*nullptr일 수 있음*

(선택 사항) 인벤토리 항목 인스턴스의 사용자 지정 키-값 쌍 세트로, 카탈로그 항목의 사용자 지정 데이터와 혼동해서는 안 됩니다.

**`customDataCount`**   uint32\_t

customData의 개수

**`displayName`**   const char\*\
*null로 종료됨*

(선택 사항) 이 항목이 구매된 시점의 CatalogItem.DisplayName입니다.

**`expiration`**   time\_t const\*\
*nullptr일 수 있음*

(선택 사항) 이 인스턴스가 만료되는 시점의 타임스탬프입니다.

**`itemClass`**   const char\*\
*null로 종료됨*

(선택 사항) 카탈로그에 정의된 인벤토리 항목의 클래스 이름입니다.

**`itemId`**   const char\*\
*null로 종료됨*

(선택 사항) 카탈로그에 정의된 인벤토리 항목의 고유 식별자입니다.

**`itemInstanceId`**   const char\*\
*null로 종료됨*

(선택 사항) 이 항목의 특정 인스턴스에 대한 고유 항목 식별자입니다.

**`purchaseDate`**   time\_t const\*\
*nullptr일 수 있음*

(선택 사항) 이 인스턴스가 구매된 시점의 타임스탬프입니다.

**`remainingUses`**   int32\_t const\*\
*nullptr일 수 있음*

(선택 사항) 소모품 항목인 경우 남은 총 사용 횟수입니다.

**`unitCurrency`**   const char\*\
*null로 종료됨*

(선택 사항) 카탈로그 항목 비용의 통화 유형입니다. 항목을 부여할 때는 사용할 수 없습니다.

**`unitPrice`**   uint32\_t

지정된 통화로 표시된 카탈로그 항목의 비용입니다. 항목을 부여할 때는 사용할 수 없습니다.

**`usesIncrementedBy`**   int32\_t const\*\
*nullptr일 수 있음*

(선택 사항) 이 호출에서 이 항목에 추가되거나 제거된 사용 횟수입니다.

## 요구 사항

**헤더:** PFTypes.h

## 함께 보기

[PFTypes 멤버](/services/playfab/api-references/c/pftypes/pftypes_members)


## Related topics

- [PFCharacterInventory](/ko/services/playfab/api-references/c/pftypes/structs/pfcharacterinventory.md)
- [Services C API 개요 - PFTypes.h](/ko/services/playfab/api-references/c/pftypes/pftypes_members.md)
- [PFGetPlayerCombinedInfoResultPayload](/ko/services/playfab/api-references/c/pftypes/structs/pfgetplayercombinedinforesultpayload.md)
- [character_consumed_item](/ko/services/playfab/api-references/events/Character/character-consumed-item.md)
- [player_consumed_item](/ko/services/playfab/api-references/events/Player/player-consumed-item.md)