User.GetUserAgeRangeAsync Метод

Определение

Пространство имен:

Windows.System

Извлекает диапазон возрастов, в который попадает текущий пользователь.

public:
 virtual IAsyncOperation<UserAgeRange ^> ^ GetUserAgeRangeAsync() = GetUserAgeRangeAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<UserAgeRange> GetUserAgeRangeAsync();

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<UserAgeRange> GetUserAgeRangeAsync();

function getUserAgeRangeAsync()

Public Function GetUserAgeRangeAsync () As IAsyncOperation(Of UserAgeRange)

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

IAsyncOperation<UserAgeRange>

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

Атрибуты

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();
    UserAgeRange range = user.GetUserAgeRangeAsync().get();

    if (range)
    {
        int32_t lower = range.Lower();
        int32_t upper = range.Upper();

        // Use the inclusive age bucket.
    }
    else
    {
        // Use the app's fallback experience.
    }
}

User user = User.GetDefault();
UserAgeRange range = await user.GetUserAgeRangeAsync();

if (range != null)
{
    int lower = range.Lower;
    int upper = range.Upper;

    // Use the inclusive age bucket.
}
else
{
    // Use the app's fallback experience.
}

Комментарии

UserAgeRange.Lower и UserAgeRange.Upper являются инклюзивными границами.

Возрастная группа	Lower	Upper
До 10	0	9
10-12	10	12
13-15	13	15
16-17	16	17
18 лет и старше	18	INT32_MAX

Операция возвращается null , когда возраст пользователя не известен, функция недоступна или API отключены политикой администрирования. Результат null является ожидаемым результатом и не должен рассматриваться как точный возраст или как 18-или более старый диапазон.

• Вызовите этот метод для объекта User для пользователя, выполняя текущий процесс. Используйте User.GetDefault для получения этого пользователя напрямую.
• Пакет приложения должен объявить возможность userAccountInformation. Вызывающий объект без доступа или вызывающий объект User для другого пользователя может получить E_ACCESSDENIED.
• Этот метод возвращает контейнер возрастов, а не точный возраст или дату рождения пользователя.
• В C++/WinRT вызовите .get() из подходящего потока, отличного от пользовательского интерфейса, или из co_await корутины.

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

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

См. также

• User
• User.GetDefault
• User.FindAllAsync
• User.GetAgeVerificationStatusAsync
• UserAgeRange