Skip to main content

XUserGetTokenAndSignatureAsync

対象 URL への HTTPS 呼び出しの認可に必要な X-token と Signature を非同期に取得する API です。タイトルの パートナー センターのシングル サインオン ページ で対象 URL に紐付けられている証明書利用者 (Relying Party) が存在する場合、X-token と Signature を返します。要求を行う前に、API の Results バージョン から取得した X-token と Signature の値を HTTPS 呼び出しの Authorization ヘッダーと Signature ヘッダーに追加してください。

構文

パラメーター

user   _In_
Type: XUserHandle
Web 要求の対象ユーザーへのハンドルです。 options   _In_
Type: XUserGetTokenAndSignatureOptions
ユーザー トークンと署名を取得するためのオプションです。 method   _In_z_
Type: char*
Web 要求のメソッド タイプです。 url   _In_z_
Type: char*
HTTPS 要求の対象 URL です。HTTPS 要求には完全な URL 文字列を使用してください。URL を省略しないでください。 headerCount   _In_
Type: size_t
headers パラメーター内のヘッダーの数です。 headers   _In_reads_opt_(headerCount)
Type: XUserGetTokenAndSignatureHttpHeader*
Web 要求のヘッダーです。 bodySize   _In_
Type: size_t
bodyBuffer パラメーターのバッファーのサイズです。 bodyBuffer   _In_reads_bytes_opt_(bodySize)
Type: void*
Web 要求の本文が格納されるバッファーです。 async   _Inout_
Type: XAsyncBlock*
呼び出しの状態のポーリングと呼び出し結果の取得に使用する XAsyncBlock です。

戻り値

Type: HRESULT 成功した場合は S_OK を返します。それ以外の場合はエラー コードを返します。 エラー コードの一覧については、エラー コード を参照してください。

解説

XUserGetTokenAndSignatureAsync の呼び出し結果を取得するには、XUserGetTokenAndSignatureResult を呼び出します。 XUserGetTokenAndSignatureAsync の呼び出し結果を保持するために必要なバッファー サイズを取得するには、XUserGetTokenAndSignatureResultSize を呼び出します。 以下の例は、ユーザーのトークンと署名を非同期に取得する方法を示しています。

要件

ヘッダー: XUser.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、Steam Deck、XBOX One ファミリ本体および XBOX Series 本体

関連項目

XUser XUserGetTokenAndSignatureResult XUserGetTokenAndSignatureResultSize
最終更新日 2026年8月24日