Skip to main content

XUserGetTokenAndSignatureAsync

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

語法

參數

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

傳回值

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

備註

若要擷取呼叫 XUserGetTokenAndSignatureAsync 的結果,請呼叫 XUserGetTokenAndSignatureResult。 若要擷取保存呼叫 XUserGetTokenAndSignatureAsync 之結果所需的緩衝區大小,請呼叫 XUserGetTokenAndSignatureResultSize。 下列範例示範如何以非同步方式擷取使用者的權杖和簽章。

需求

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

另請參閱

XUser XUserGetTokenAndSignatureResult XUserGetTokenAndSignatureResultSize
Last modified on October 6, 2026