User.GetAgeVerificationStatusAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
检索一个值,该值指示当前用户的年龄是否已验证以及验证方式。
public:
virtual IAsyncOperation<UserAgeVerificationStatus> ^ GetAgeVerificationStatusAsync() = GetAgeVerificationStatusAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<UserAgeVerificationStatus> GetAgeVerificationStatusAsync();
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<UserAgeVerificationStatus> GetAgeVerificationStatusAsync();
function getAgeVerificationStatusAsync()
Public Function GetAgeVerificationStatusAsync () As IAsyncOperation(Of UserAgeVerificationStatus)
返回
返回当前用户的 UserAgeVerificationStatus 值的异步操作。
- 属性
Windows 要求
| 要求 | 说明 |
|---|---|
| 设备系列 |
Windows 11, version 24H2 (在 10.0.26100.0 中引入)
|
| API contract |
Windows.Foundation.UniversalApiContract (在 v19.0 中引入)
|
| 应用功能 |
userAccountInformation
|
示例
#include <winrt/Windows.Foundation.h>
#include <winrt/Windows.System.h>
using namespace winrt;
using namespace winrt::Windows::System;
int wmain()
{
init_apartment();
User user = User::GetDefault();
UserAgeVerificationStatus status =
user.GetAgeVerificationStatusAsync().get();
switch (status)
{
case UserAgeVerificationStatus::Verified:
// The user's age is verified.
break;
case UserAgeVerificationStatus::Unverified:
// The user's age isn't verified.
break;
case UserAgeVerificationStatus::OptedOut:
// The user opted out.
break;
case UserAgeVerificationStatus::TemporarilyUnavailable:
// Retry later or use the app's fallback experience.
break;
case UserAgeVerificationStatus::NotApplicable:
// Use the app's fallback experience.
break;
}
}
User user = User.GetDefault();
UserAgeVerificationStatus status =
await user.GetAgeVerificationStatusAsync();
switch (status)
{
case UserAgeVerificationStatus.Verified:
break;
case UserAgeVerificationStatus.Unverified:
break;
case UserAgeVerificationStatus.OptedOut:
break;
case UserAgeVerificationStatus.TemporarilyUnavailable:
break;
case UserAgeVerificationStatus.NotApplicable:
break;
}
注解
下表描述了可能的返回值。
| 价值 | 名称 | Meaning |
|---|---|---|
| 0 | NotApplicable |
年龄验证不适用,没有可用的验证信号,或者该功能不可用或已禁用。 |
| 1 | TemporarilyUnavailable |
目前无法确定验证状态。 应用稍后可以重试。 |
| 2 | Unverified |
用户的年龄尚未验证。 |
| 3 | OptedOut |
用户已选择退出年龄验证。 |
| 4 | Verified |
已验证用户的年龄。 |
NotApplicable 并且 TemporarilyUnavailable 不确定用户已验证或未验证。 将它们作为单独的状态进行处理。
- 对运行当前进程的用户的 User 对象调用此方法。 使用 User.GetDefault 直接获取该用户。
- 应用包必须声明
userAccountInformation该功能。 没有访问权限的调用方或对其他用户使用User对象的调用方可以接收E_ACCESSDENIED。 - 在 C++/WinRT 中,从合适的非 UI 线程调用
.get()或使用co_await协同例程。
管理策略
管理员可以禁用数字安全年龄 API,或者通过组策略或 MDM 配置默认验证状态。 禁用 API 时,此方法返回 NotApplicable。 配置默认状态时,此方法返回已配置 Verified 或 Unverified 值。