XStoreGetUserCollectionsIdAsync
取得客戶集合識別碼。接著,您可以使用此識別碼,透過 B2B 呼叫從您自己的服務驗證使用者的權利。此 API 用於從您的服務管理產品中所述的流程。語法
參數
storeContextHandle _In_類型:XStoreContextHandle XStoreCreateContext 所傳回之使用者的市集內容控制代碼。 serviceTicket _In_z_
類型:char* 後端服務可用來授權使用者和服務的 Azure 票證。這可讓您從服務取回票證,然後轉送給您自己的伺服器。接著,您的伺服器可以儲存此票證,並將其用於 B2B 呼叫,以檢查擁有權或授與存取權。 publisherUserId _In_z_
類型:char* 由開發人員產生的字串,用來將目前使用者識別為屬於遊戲、開發人員或發行者之服務的成員或來賓。此字串的內容由開發人員決定,也可以保留空白。 async _Inout_
類型:XAsyncBlock* 定義正在進行之非同步工作的 XAsyncBlock。XAsyncBlock 可用來輪詢呼叫的狀態並擷取呼叫結果。如需詳細資訊,請參閱 XAsyncBlock。
傳回值
類型:HRESULT HRESULT 成功或錯誤碼。備註
在 PC 上,如果已啟用 XBOX services,此 API 會傳回目前登入市集之使用者的資訊,而不一定是正在玩您遊戲的使用者。如果您的遊戲位於 XBOX 主機上,或在 PC 上啟用 XBOX services,建議您使用 XSTS 委派授權對集合和授權預覽端點進行 B2B 呼叫,以確保您檢查的是目前正在玩遊戲之使用者的權利。 若要擷取使用者的集合識別碼以及此函式的執行結果,請在呼叫此函式之後呼叫 XStoreGetUserCollectionsIdResult。若要擷取使用者集合識別碼的大小,請呼叫 XStoreGetUserCollectionsIdResultSize。知道結果的大小可讓您更有效率地擷取結果。 下列程式碼片段示範如何擷取客戶集合識別碼。需求
標頭: XStore.h (包含在 XGameRuntime.h 中) 程式庫: xgameruntime.lib 支援的平台: Windows、XBOX One 系列主機和 XBOX Series 主機概念文件
另請參閱
XStoreXStoreGetUserCollectionsIdResult
從您的服務管理產品
