Skip to main content

XStoreGetUserCollectionsIdAsync

顧客コレクション ID を取得します。この ID は、B2B 呼び出しを使用して独自のサービスからユーザーの権利を検証するために使用できます。この API は、サービスから製品を管理するで説明されているフローで使用されます。

構文

パラメーター

storeContextHandle   _In_
Type: XStoreContextHandle
XStoreCreateContext から返される、ユーザーのストア コンテキスト ハンドル。 serviceTicket   _In_z_
Type: char*
バックエンド サービスがユーザーとサービスを認可するために使用できる Azure チケット。これにより、サービスからチケットを取得して独自のサーバーに中継できます。その後、サーバーはこれを保存し、所有権のチェックやアクセスの付与を行う B2B 呼び出しに使用できます。 publisherUserId   _In_z_
Type: char*
現在のユーザーを、ゲーム、開発者、またはパブリッシャーに属するサービスのメンバーまたはゲストとして識別することを目的として、開発者によって生成される文字列。この文字列の内容は開発者によって決定され、空欄のままにすることもできます。 async   _Inout_
Type: XAsyncBlock*
実行中の非同期処理を定義する XAsyncBlockXAsyncBlock は、呼び出しの状態のポーリングと呼び出し結果の取得に使用できます。詳細については、XAsyncBlock を参照してください。

戻り値

Type: HRESULT HRESULT の成功またはエラー コード。

解説

PC では、XBOX サービスが有効な場合、この API はストアに現在サインインしているユーザーの情報を返し、必ずしもゲームをプレイしているユーザーの情報を返すとは限りません。タイトルが XBOX コンソール上にあるか、PC で XBOX サービスが有効になっている場合は、実際にプレイしているユーザーの権利を確認するために、XSTS 委任認可を使用してコレクションおよびライセンス プレビュー エンドポイントへの B2B 呼び出しを行うことをお勧めします。 ユーザーのコレクション ID とこの関数の実行結果を取得するには、この関数を呼び出した後に XStoreGetUserCollectionsIdResult を呼び出します。ユーザーのコレクション ID のサイズを取得するには、XStoreGetUserCollectionsIdResultSize を呼び出します。結果のサイズを事前に知ることで、より効率的に取得できます。 次のコード スニペットは、顧客コレクション ID を取得する例を示しています。

要件

ヘッダー: XStore.h (XGameRuntime.h に含まれる) ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、XBOX One 本体および XBOX Series 本体

関連概念ドキュメント

関連項目

XStore
XStoreGetUserCollectionsIdResult
サービスから製品を管理する
最終更新日 2026年8月24日