通过

XUserGetTokenAndSignatureUtf16Async

异步检索授权目标 URL 的 HTTPS 调用所需的 X 令牌和签名的 API。 如果 合作伙伴中心的游戏单一登录页中存在绑定到目标 URL 的信赖方，这将返回 X 令牌和签名。 在发出请求之前，将 API 的结果版本 中的 X 令牌和签名值添加到 HTTPS 调用的 Authorization 和 Signature 标头。

语法

HRESULT XUserGetTokenAndSignatureUtf16Async(  
         XUserHandle user,  
         XUserGetTokenAndSignatureOptions options,  
         const wchar_t* method,  
         const wchar_t* url,  
         size_t headerCount,  
         const XUserGetTokenAndSignatureUtf16HttpHeader* headers,  
         size_t bodySize,  
         const void* bodyBuffer,  
         XAsyncBlock* async  
)

参数

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 updated on