> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XStoreCollectionData

> XStoreCollectionData

# XStoreCollectionData

描述使用者對特定 SKU 的權利。

## 語法

```cpp theme={null}
typedef struct XStoreCollectionData {  
    time_t acquiredDate;  
    time_t startDate;  
    time_t endDate;  
    bool isTrial;  
    uint32_t trialTimeRemainingInSeconds;  
    uint32_t quantity;  
    const char* campaignId;  
    const char* developerOfferId;  
} XStoreCollectionData  
```

### 成員

*acquiredDate*\
類型：time\_t

取得權利的日期。

*startDate*\
類型：time\_t

權利的開始日期。

*endDate*\
類型：time\_t

權利的結束日期。

*isTrial*\
類型：bool

指出權利是否為試用版。

*trialTimeRemainingInSeconds*\
類型：uint32\_t

試用版的剩餘時間。

*quantity*\
類型：uint32\_t

權利中的項目數目。對於消耗性產品，此值代表剩餘餘額。

*campaignId*\
類型：const char\*

權利的行銷活動識別碼。

*developerOfferId*\
類型：const char\*

開發人員優惠識別碼。

## 備註

**XStoreCollectionData** 提供有關商店產品庫存單位 (SKU) 的其他資訊。**XStoreCollectionData** 可能參照多種類型的產品或產品集合。因此，如果某些欄位不適用於該 SKU，則可能沒有值。\*\*XStoreCollectionData 是 [StoreSku](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoresku.md) 結構的成員。

## 需求

**標頭：** XStore.h (包含在 XGameRuntime.h 中)

**支援的平台：** Windows、XBOX One 系列主機和 XBOX Series 主機

## 概念文件

* [Store 開發權利工具 (DevEntitlementTool.exe)](https://docs.xbox.com/zh-TW/tools/tools-services/live-dev-entitlements-tool.md)

## 另請參閱

[XStore](https://docs.xbox.com/zh-TW/reference/system/xstore/xstore_members.md)\
[XStoreSku](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoresku.md)


## Related topics

- [Store 開發權利工具 (DevEntitlementTool.exe)](https://docs.xbox.com/zh-TW/tools/tools-services/live-dev-entitlements-tool.md)
- [XStoreSku](https://docs.xbox.com/zh-TW/reference/system/xstore/structs/xstoresku.md)
- [XStore (API 內容)](https://docs.xbox.com/zh-TW/reference/system/xstore/xstore_members.md)
- [collections.mp.microsoft.com/v9.0/collections/publisherQuery](https://docs.xbox.com/zh-TW/reference/microsoft-store-apis/xstore-v9-query-for-products.md)
- [collections.mp.microsoft.com/v8.0/collections/consume](https://docs.xbox.com/zh-TW/reference/microsoft-store-apis/xstore-v8-consume.md)