Язык

User.GetAgeVerificationStatusAsync Метод

Определение

Пространство имен:
Windows.System
Изменить

Извлекает значение, указывающее, был ли проверен возраст текущего пользователя.

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)

Возвращаемое значение

IAsyncOperation<UserAgeVerificationStatus>

Асинхронная операция, возвращающая значение UserAgeVerificationStatus для текущего пользователя.

Атрибуты
RemoteAsyncAttribute

Требования к 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 вызовите .get() из подходящего потока, отличного от пользовательского интерфейса, или из co_await корутины.

Политика администрирования

Администраторы могут отключить API возраста цифровой безопасности или настроить состояние проверки по умолчанию с помощью групповой политики или MDM. Если API отключены, этот метод возвращается NotApplicable. При настройке состояния по умолчанию этот метод возвращает настроенное Verified или Unverified значение.

Применяется к

См. также