PFAuthenticationServerLoginWithXboxAsync
从外部服务器后端使用Xbox Live令牌登录用户,并返回会话标识符,该标识符随后可用于需要经过身份验证的用户的 API 调用
语法
HRESULT PFAuthenticationServerLoginWithXboxAsync(
PFServiceConfigHandle serviceConfigHandle,
const char* secretKey,
const PFAuthenticationServerLoginWithXboxRequest* request,
XAsyncBlock* async
)
参数
serviceConfigHandle
PFServiceConfigHandle
从 PFServiceConfigCreateHandle 调用返回的 PFServiceConfigHandle。
secretKey
char*
In_z
用于对服务请求进行身份验证的游戏密钥。
request
PFAuthenticationServerLoginWithXboxRequest*
已填充的请求对象。
async
XAsyncBlock*
Inout
异步操作的 XAsyncBlock。
返回值
类型:HRESULT
此 API 操作的结果代码。
备注
此 API 在 Win32、Linux 和 macOS 上可用。 如果这是用户首次使用 Xbox Live 帐户登录,并且 CreateAccount 设置为 true,则将创建新的 PlayFab 帐户并将其链接到 Xbox Live 帐户。 在这种情况下,不会将任何电子邮件或用户名与 PlayFab 帐户关联。 否则,如果没有 PlayFab 帐户链接到 Xbox Live 帐户,则会返回一个错误,指示将返回此帐户,以便游戏可以指导用户完成 PlayFab 帐户的创建。 另请参阅 ServerLinkXboxAccountAsync、ServerUnlinkXboxAccountAsync。 异步任务完成后,请调用 PFAuthenticationServerLoginWithXboxGetResult 获取结果。
要求
标头:PFAuthentication.h