User.GetUserAgeRangeAsync Método

Definição

Namespace:

Windows.System

Recupera a faixa etária na qual o usuário atual se enquadra.

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)

Retornos

IAsyncOperation<UserAgeRange>

Uma operação assíncrona que retorna um UserAgeRange para o usuário atual ou null quando a faixa etária é desconhecida ou indisponível.

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Requisitos	Description
Família de dispositivos	Windows 11, version 24H2 (introduzida na 10.0.26100.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v19.0)
Funcionalidades do aplicativo	userAccountInformation

Exemplos

#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.
}

Comentários

UserAgeRange.Lower e UserAgeRange.Upper são limites inclusivos.

Faixa etária	Lower	Upper
Menos de 10	0	9
10-12	10	12
13-15	13	15
16-17	16	17
18 anos ou mais	18	INT32_MAX

A operação retorna null quando a idade do usuário não é conhecida, o recurso não está disponível ou as APIs são desabilitadas pela política administrativa. Um null resultado é um resultado esperado e não deve ser tratado como uma idade exata ou como a faixa de 18 anos ou mais.

• Chame esse método no objeto User para o usuário que executa o processo atual. Use User.GetDefault para obter esse usuário diretamente.
• O pacote do aplicativo deve declarar a userAccountInformation funcionalidade. Um chamador sem acesso ou um chamador usando um User objeto para um usuário diferente pode receber E_ACCESSDENIED.
• Esse método retorna um bucket de idade, não a idade exata ou a data de nascimento do usuário.
• No C++/WinRT, chame .get() de um thread não de interface do usuário adequado ou use co_await de uma coroutina.

Política administrativa

Os administradores podem desabilitar as APIs de idade de Segurança Digital ou configurar uma faixa etária padrão por meio da Política de Grupo ou do MDM. Quando as APIs são desabilitadas, esse método retorna null. Quando uma faixa etária padrão é configurada, esse método retorna o UserAgeRange que corresponde a esse grupo.

Confira também

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