Skip to main content

XUserGetTokenAndSignatureUtf16Async

以异步方式检索授权对目标 URL 的 HTTPS 调用所需的 X 令牌和签名的 API。如果在标题的合作伙伴中心单一登录页面中存在与目标 URL 关联的信赖方,则会返回 X 令牌和签名。在发出请求之前,将 API 的结果版本中的 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
最后修改于 2026年8月24日