Skip to main content

XUserGetTokenAndSignatureAsync

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