Skip to main content

XUserGetTokenAndSignatureUtf16Async

以非同步方式擷取授權對目標 URL 進行 HTTPS 呼叫所需之 X 權杖和簽章的 API。如果在遊戲的 Partner Center 單一登入頁面中有與目標 URL 關聯的信賴憑證者,此 API 會傳回 X 權杖和簽章。在提出要求之前,請將 API 的 Result 版本所提供的 X 權杖和簽章值新增至 HTTPS 呼叫的 Authorization 和 Signature 標頭。

語法

參數

user   _In_
類型:XUserHandle
Web 要求所屬使用者的控制代碼。 options   _In_
類型:XUserGetTokenAndSignatureOptions
擷取使用者權杖和簽章的選項。 method   _In_z_
類型:wchar_t*
Web 要求的方法類型 (Unicode)。 url   _In_z_
類型:wchar_t*
HTTPS 要求的目標 URL。請為 HTTPS 要求使用完整的 URL 字串。請勿縮寫 URL。 headerCount   _In_
類型:size_t
headers 參數中的標頭數目。 headers   _In_reads_opt_(headerCount)
類型:XUserGetTokenAndSignatureUtf16HttpHeader*
Web 要求的標頭。 bodySize   _In_
類型:size_t
bodyBuffer 參數中緩衝區的大小。 bodyBuffer   _In_reads_bytes_opt_(bodySize)
類型:void*
包含 Web 要求本文的緩衝區。 async   _Inout_
類型:XAsyncBlock*
用於輪詢呼叫狀態並擷取呼叫結果的 XAsyncBlock。

傳回值

類型:HRESULT 如果成功,則傳回 S_OK;否則傳回錯誤碼。 如需錯誤碼清單,請參閱錯誤碼。

備註

XUserGetTokenAndSignatureUtf16Async 函式使用 XUserGetTokenAndSignatureOptions 列舉引數,以非同步方式擷取 Web 要求的 Unicode X 權杖和簽章。 若要擷取呼叫 XUserGetTokenAndSignatureUtf16Async 的結果,請呼叫 XUserGetTokenAndSignatureUtf16Result。 若要擷取保存呼叫 XUserGetTokenAndSignatureUtf16Async 之結果所需的緩衝區大小,請呼叫 XUserGetTokenAndSignatureUtf16ResultSize。

需求

標頭: XUser.h 程式庫: xgameruntime.lib 支援的平台: Windows、Steam Deck、XBOX One 系列主機和 XBOX Series 主機

概念文件

另請參閱

XUser XUserGetTokenAndSignatureUtf16Result XUserGetTokenAndSignatureUtf16ResultSize
Last modified on October 6, 2026