XStore

XStore API 的參考資料。為遊戲提供商務相關功能，包括可購買內容的詳細資料、可下載內容套件管理、授權管理，以及遊戲試用版。

函式

函式	描述
XStoreAcquireLicenseForDurablesAsync	取得指定耐久性商品的授權。
XStoreAcquireLicenseForDurablesResult	擷取 XStoreAcquireLicenseForDurablesAsync 呼叫的結果。
XStoreAcquireLicenseForPackageAsync	取得使用者有權使用之遊戲 DLC 的授權。
XStoreAcquireLicenseForPackageResult	擷取 XStoreAcquireLicenseForPackageAsync 呼叫的結果。
XStoreCanAcquireLicenseForPackageAsync	擷取 DLC 的預覽授權。
XStoreCanAcquireLicenseForPackageResult	取得 XStoreCanAcquireLicenseForPackageAsync 呼叫的結果。
XStoreCanAcquireLicenseForStoreIdAsync	擷取內容的預覽授權。
XStoreCanAcquireLicenseForStoreIdResult	取得 XStoreCanAcquireLicenseForStoreIdAsync 呼叫的結果。
XStoreCloseContextHandle	關閉指定的市集內容控制代碼。
XStoreCloseLicenseHandle	關閉指定的市集授權控制代碼。
XStoreCloseProductsQueryHandle	關閉指定的市集產品查詢控制代碼。
XStoreCreateContext	為指定的使用者建立市集內容。
XStoreDownloadAndInstallPackagesAsync	下載並安裝指定的市集套件。
XStoreDownloadAndInstallPackagesResult	取得 XStoreDownloadAndInstallPackagesAsync 呼叫的結果。
XStoreDownloadAndInstallPackagesResultCount	取得 XStoreDownloadAndInstallPackagesResult 將傳回之結果中的項目數目。
XStoreDownloadAndInstallPackageUpdatesAsync	下載並安裝指定市集套件的更新。
XStoreDownloadAndInstallPackageUpdatesResult	取得 XStoreDownloadAndInstallPackageUpdatesAsync 呼叫的結果。
XStoreDownloadPackageUpdatesAsync	下載指定套件的更新。
XStoreDownloadPackageUpdatesResult	取得 XStoreDownloadPackageUpdatesAsync 呼叫的結果。
XStoreEnumerateProductsQuery	列舉產品查詢的結果。
XStoreGameLicenseChangedCallback	遊戲定義的回呼，用於遊戲授權變更事件。
XStoreGetUserCollectionsIdAsync	取得客戶收藏 ID。
XStoreGetUserCollectionsIdResult	取得 XStoreGetUserCollectionsIdAsync 呼叫的結果。
XStoreGetUserCollectionsIdResultSize	取得 XStoreGetUserCollectionsIdResult 所傳回 ID 的大小。
XStoreGetUserPurchaseIdAsync	擷取客戶購買 ID。
XStoreGetUserPurchaseIdResult	取得 XStoreGetUserPurchaseIdAsync 呼叫的結果。
XStoreGetUserPurchaseIdResultSize	取得 XStoreGetUserPurchaseIdResult 所傳回結果的大小。
XStoreIsLicenseValid	檢查指定的授權是否有效。
XStorePackageLicenseLostCallback	遊戲定義的回呼，用於授權遺失事件。
XStoreProductQueryCallback	遊戲定義的回呼，用於產品查詢。
XStoreProductsQueryHasMorePages	檢查指定的查詢是否還有更多結果頁面。
XStoreProductsQueryNextPageAsync	取得下一頁查詢結果。
XStoreProductsQueryNextPageResult	取得產品查詢的下一頁結果。
XStoreQueryAddOnLicensesAsync	列舉使用者針對目前執行中遊戲之無位元耐久性商品所獲授與的授權。
XStoreQueryAddOnLicensesResult	擷取 XStoreQueryAddOnLicensesAsync 呼叫的結果。
XStoreQueryAddOnLicensesResultCount	取得 XStoreQueryAddonLicensesAsync 所擷取的授權數目。
XStoreQueryAssociatedProductsAsync	取得可從目前遊戲內購買之產品的市集清單資訊。
XStoreQueryAssociatedProductsForStoreIdAsync	取得可從市集 ID 所指定之產品購買之產品的市集清單資訊。
XStoreQueryAssociatedProductsForStoreIdResult	取得 XStoreQueryAssociatedProductsForStoreIdAsync 呼叫的結果。
XStoreQueryAssociatedProductsResult	取得 XStoreQueryAssociatedProductsAsync 呼叫的結果。
XStoreQueryConsumableBalanceRemainingAsync	取得指定產品 ID 的消耗性商品剩餘餘額。
XStoreQueryConsumableBalanceRemainingResult	擷取 XStoreQueryConsumableBalanceRemainingAsync 呼叫的結果。
XStoreQueryEntitledProductsAsync	提供使用者已購買之目前遊戲所有附加元件的市集產品資訊。
XStoreQueryEntitledProductsResult	取得 XStoreQueryEntitledProductsAsync 呼叫的結果。
XStoreQueryGameAndDlcPackageUpdatesAsync	取得目前套件的遊戲更新與選用更新。
XStoreQueryGameAndDlcPackageUpdatesResult	取得 XStoreQueryGameAndDlcPackageUpdatesAsync 呼叫的結果。
XStoreQueryGameAndDlcPackageUpdatesResultCount	取得 XStoreQueryGameAndDlcPackageUpdatesAsync 所擷取的更新數目。
XStoreQueryGameLicenseAsync	擷取為允許遊戲啟動而取得之授權的相關資訊。
XStoreQueryGameLicenseResult	取得 XStoreQueryGameLicenseAsync 呼叫的結果。
XStoreQueryLicenseTokenAsync	向呼叫的遊戲提供不透明權杖，可傳遞至遊戲的服務以進行 B2B 呼叫。
XStoreQueryLicenseTokenResult	擷取 XStoreQueryLicenseTokenAsync 呼叫的結果。
XStoreQueryLicenseTokenResultSize	取得 XstoreQueryLicenseTokenResult 將傳回之結果的大小。
XStoreQueryPackageIdentifier	擷取指定市集 ID 的套件識別碼。
XStoreQueryPackageUpdatesAsync	擷取指定套件的可用更新。
XStoreQueryPackageUpdatesResult	取得 XStoreQueryPackageUpdatesAsync 呼叫的結果。
XStoreQueryPackageUpdatesResultCount	取得 XStoreQueryPackageUpdatesAsync 所擷取的更新數目。
XStoreQueryProductForCurrentGameAsync	提供目前執行中遊戲的市集產品資訊、其 SKU 和供應情況，以及其他中繼資料。
XStoreQueryProductForCurrentGameResult	取得 XStoreQueryProductForCurrentGameAsync 呼叫的結果。
XStoreQueryProductForPackageAsync	擷取指定套件的市集產品資訊。
XStoreQueryProductForPackageResult	取得 XStoreQueryProductForPackageAsync 呼叫的結果。
XStoreQueryProductsAsync	傳回與目前遊戲相關聯之指定產品的清單資訊，無論這些產品目前是否可在目前遊戲內購買。
XStoreQueryProductsResult	取得 XStoreQueryProductsAsync 呼叫的結果。
XStoreRegisterGameLicenseChanged	註冊遊戲授權變更事件的回呼。
XStoreRegisterPackageLicenseLost	註冊授權遺失事件的回呼。
XStoreReportConsumableFulfillmentAsync	消耗指定數量的消耗性商品。
XStoreReportConsumableFulfillmentResult	取得 XStoreReportConsumableFulfillmentAsync 呼叫的結果。
XStoreShowAssociatedProductsUIAsync	這會開啟 Microsoft Store 應用程式，並顯示與遊戲相關聯的可用附加元件集合。可依產品類型進一步篩選。
XStoreShowAssociatedProductsUIResult	取得 XStoreShowAssociatedProductsUIAsync 呼叫的結果。
XStoreShowGiftingUIAsync	允許遊戲要求購買特定市集產品作為送給其他使用者的禮物。
XStoreShowGiftingUIResult	取得 XStoreShowGiftingUIAsync 呼叫的結果。
XStoreShowProductPageUIAsync	直接將市集應用程式開啟至指定 ProductId 的詳細資料頁面。
XStoreShowProductPageUIResult	取得 XStoreShowProductPageUIAsync 呼叫的結果。
XStoreShowPurchaseUIAsync	允許遊戲要求購買特定市集產品。
XStoreShowPurchaseUIResult	取得 XStoreShowPurchaseUIAsync 呼叫的結果。
XStoreShowRateAndReviewUIAsync	顯示快顯系統對話方塊，讓使用者提供評論或拒絕提供評論。
XStoreShowRateAndReviewUIResult	取得 XStoreShowRateAndReviewUIAsync 呼叫的結果。
XStoreShowRedeemTokenUIAsync	為目前使用者觸發指定權杖的兌換。
XStoreShowRedeemTokenUIResult	取得 XStoreShowRedeemTokenUIAsync 呼叫的結果。
XStoreUnregisterGameLicenseChanged	取消註冊指定的遊戲授權變更回呼。
XStoreUnregisterPackageLicenseLost	取消註冊指定的市集授權遺失回呼。

結構

結構	描述
XStoreAddonLicense	描述附加元件授權。
XStoreAvailability	描述產品的供應情況。
XStoreCanAcquireLicenseResult	取得 XStoreCanAcquireLicenseForPackageAsync 或 XStoreCanAcquireLicenseForStoreIdAsync 呼叫的結果。
XStoreCollectionData	描述市集收藏。
XStoreConsumableResult	代表消耗性商品的數量。
XStoreGameLicense	描述遊戲授權。
XStoreImage	描述影像。
XStorePackageUpdate	描述套件更新。
XStorePrice	市集價格資訊。
XStoreProduct	描述市集產品。
XStoreRateAndReviewResult	XStoreShowRateAndReviewUIAsync 呼叫的結果。
XStoreSku	描述市集 SKU。
XStoreSubscriptionInfo	包含訂閱的相關資訊。
XStoreVideo	描述市集影片。

列舉

列舉	描述
XStoreCanLicenseStatus	指出使用者是否能夠授權套件。
XStoreDurationUnit	期間值的單位。
XStoreProductKind	指出產品類型。

錯誤碼

XStore API 可能會傳回下列錯誤碼。如需完整清單，請參閱錯誤碼。

代碼	值	描述
E_GAMESTORE_LICENSE_ACTION_NOT_APPLICABLE_TO_PRODUCT	0x89245300	遊戲要求了無法授權之產品的授權。
E_GAMESTORE_NETWORK_ERROR	0x89245301	遊戲無法與市集網路通訊。
E_GAMESTORE_SERVER_ERROR	0x89245302	遊戲從市集伺服器收到錯誤的回應。
E_GAMESTORE_INSUFFICIENT_QUANTITY	0x89245303	使用者擁有的此消耗性商品數量不足以使用要求的數量。
E_GAMESTORE_ALREADY_PURCHASED	0x89245304	使用者已擁有此產品。
E_GAMESTORE_LICENSE_ACTION_THROTTLED	0x89245305	遊戲過度查詢產品的授權，目前已受到節流。同一產品的限制為 10 分鐘內 30 次授權嘗試。

概念文件

另請參閱

系統 API 參考
XPackage API 參考
商務概觀

Introduction

Onboarding & Access

Setup & Install

Build Your First Title

XStore

XStore

函式

結構

列舉

錯誤碼

概念文件

另請參閱

​XStore

​函式

​結構

​列舉

​錯誤碼

​概念文件

​另請參閱

XStore

函式

結構

列舉

錯誤碼

概念文件

另請參閱