Skip to main content

XStoreQueryLicenseTokenAsync

為呼叫的遊戲提供不透明的 JSON Web 權杖,可傳遞給遊戲的服務以驗證權利並進行 B2B 呼叫。如需詳細資訊,請參閱授權權杖概觀。

語法

參數

storeContextHandle   _In_
類型:XStoreContextHandle
由 XStoreCreateContext 傳回的使用者市集內容控制代碼。 productIds   _In_z_count_(productIdsCount)
類型:char**
要擷取權杖的產品識別碼陣列。 productIdsCount   _In_
類型:size_t
傳入 productIds 之陣列中的識別碼數目。 customDeveloperString   _In_z_
類型:char*
會往返傳入權杖中的值。此值通常由服務選擇。您可以插入使用者識別碼或電子郵件之類的內容,以便在授權權杖中追蹤使用者的權杖。授權權杖的用途類似擁有權的收據。 此值不可為 null 或空字串。 async   _Inout_
類型:XAsyncBlock*
定義正在進行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。

傳回值

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

備註

若要擷取 JSON Web 權杖以及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreQueryLicenseTokenResult。若要擷取 JSON Web 權杖的大小,請在呼叫此函式之後呼叫 XStoreQueryLicenseTokenResultSize。知道權杖的大小可讓您更有效率地擷取權杖。 授權權杖是以 Base64 編碼的 JSON Web 權杖。權杖的承載是以 Base64 編碼的字串,可轉換成可在伺服器上用於驗證的 JSON 值。 下列程式碼片段示範擷取授權權杖的範例。

需求

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

概念文件

另請參閱

XStore 授權權杖概觀 XStoreQueryLicenseTokenResult XStoreQueryLicenseTokenResultSize
Last modified on October 6, 2026