> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XGameUiWebAuthenticationResultData

> XGameUiWebAuthenticationResultData

# XGameUiWebAuthenticationResultData

包含 Web 身份验证请求的响应。

## 语法

```cpp theme={null}
typedef struct XGameUiWebAuthenticationResultData {  
    HRESULT responseStatus ;  
    size_t responseCompletionUriSize;  
    const char* responseCompletionUri;  
} XGameUiWebAuthenticationResultData  
```

### 成员

*responseStatus*
类型：HRESULT

指示 Web 视图身份验证的状态。成功时为 `S_OK`；如果用户通过点击“返回”按钮手动关闭 Web 视图，则为 `E_CANCELLED`。

*responseCompletionUriSize*\
类型：size\_t

响应数据的大小（以字节为单位），存储在 *responseCompletionUri* 中。

*responseCompletionUri*\
类型：const char\*

完整的响应数据，采用 URI 格式。

## 备注

调用 [XGameUiShowWebAuthenticationResult](/reference/system/xgameui/functions/xgameuishowwebauthenticationresult) 后，你可以访问此结构。

你可以检查 *responseStatus* 字段以查看授权请求是否成功。如果身份验证浏览器成功导航到完成 URI，则该字段将包含 `S_OK`；否则将包含 `E_CANCELLED`，表示用户通过按“返回”取消了操作。

如果授权请求成功，则响应数据将包含基础回调 URI 以及 OAuth 提供程序在验证用户后附加的所有参数（如访问令牌、过期时间等）。

如果授权请求被取消，则响应数据将为空字符串。

## 要求

**标头：** XGameUI.h

**支持的平台：** Windows、XBOX One 系列主机和 XBOX Series 主机

## 请参阅

[XGameUI](/reference/system/xgameui/xgameui_members)\
[XGameUiShowWebAuthenticationAsync](/reference/system/xgameui/functions/xgameuishowwebauthenticationasync)\
[XGameUiShowWebAuthenticationResultSize](/reference/system/xgameui/functions/xgameuishowwebauthenticationresultsize)\
[XGameUiShowWebAuthenticationResult](/reference/system/xgameui/functions/xgameuishowwebauthenticationresult)\
[异步编程模型](/build/core-features/common/async/async-programming-model)


## Related topics

- [XGameUiShowWebAuthenticationResult](/zh-CN/reference/system/xgameui/functions/xgameuishowwebauthenticationresult.md)
- [XGameUiShowWebAuthenticationResultSize](/zh-CN/reference/system/xgameui/functions/xgameuishowwebauthenticationresultsize.md)
- [XGameUiShowWebAuthenticationAsync](/zh-CN/reference/system/xgameui/functions/xgameuishowwebauthenticationasync.md)
- [XGameUiShowWebAuthenticationWithOptionsAsync](/zh-CN/reference/system/xgameui/functions/xgameuishowwebauthenticationwithoptionsasync.md)
- [XGameUI](/zh-CN/reference/system/xgameui/xgameui_members.md)
