语言

User.GetAgeVerificationStatusAsync 方法

定义

检索一个值,该值指示当前用户的年龄是否已验证以及验证方式。

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 值。

适用于

另请参阅