XUserGetMsaTokenSilentlyAsync

异步检索用户 MSA 令牌。

语法

HRESULT XUserGetMsaTokenSilentlyAsync(  
         XUserHandle user,
		 XUserGetMsaTokenSilentlyOptions options,
         const char* scope,  
         XAsyncBlock* async  
)  

参数

user _In_
类型:XUserHandle

要提取其 MSA 令牌的用户的句柄。

选项 _In_In_

检索 MSA 令牌的选项。

范围 _In_z_
类型:char*

Web 请求的范围。

async _Inout_
类型:XAsyncBlock*

用于轮询调用的状态和检索调用结果的 XAsyncBlock

返回值

类型:HRESULT

如果成功,则返回 S_OK;否则返回错误代码。 有关错误代码的列表,请参阅错误代码

备注

此 API 利用 WebAuthenticationCoreManager.GetTokenSilentlyAsync 方法。 此调用始终使用 “https://login.microsoft.com" 的提供程序,以及与 MSA 应用 ID 对应的客户端,该 ID 是 microsoftgame.config 的一部分。请求配置为“api-version”2.0。

异步结果完成后,如果有任何错误,游戏将需要调用 XGameUiShowWebAuthenticationAsync 才能获取 MSA 令牌。

要求

头文件:XUser.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XUser

XUserGetMsaTokenSilentlyResult

XUserGetMsaTokenSilentlyOptions