Skip to main content

XStoreGetUserPurchaseIdAsync

取得客戶購買識別碼。此識別碼會擷取 Microsoft Store 識別碼金鑰,可用來代表目前使用者授與免費產品的權利。此 API 用於從您的服務管理產品中所述的流程

語法

參數

storeContextHandle   _In_
類型:XStoreContextHandle
XStoreCreateContext 所傳回之使用者的市集內容控制代碼。 serviceTicket   _In_z_
類型:char*
與購買相關聯的服務票證。 publisherUserId   _In_z_
類型:char*
包含發行者使用者識別碼的字串。 async   _Inout_
類型:XAsyncBlock*
定義正在進行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。

傳回值

類型:HRESULT HRESULT 成功或錯誤碼。

備註

若要擷取客戶的購買識別碼以及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreGetUserPurchaseIdResult。若要擷取客戶購買識別碼的大小,請在呼叫此函式之後呼叫 XStoreGetUSerPurchaseIdResultSize。知道結果大小可協助您更有效率地讀取結果。 下列程式碼片段示範如何擷取客戶購買識別碼。

需求

標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XStore
XStoreGetUserPurchaseIdResult
XStoreGetUSerPurchaseIdResultSize
從您的服務管理產品
Last modified on October 6, 2026