Idioma

User.GetAgeVerificationStatusAsync Método

Definição

Namespace:
Windows.System
Editar

Recupera um valor que indica se e como a idade do usuário atual foi verificada.

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)

Retornos

IAsyncOperation<UserAgeVerificationStatus>

Uma operação assíncrona que retorna um valor UserAgeVerificationStatus para o usuário atual.

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();
    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;
}

Comentários

A tabela a seguir descreve os possíveis valores retornados.

Valor Name Meaning
0 NotApplicable A verificação de idade não se aplica, nenhum sinal de verificação está disponível ou o recurso está indisponível ou desabilitado.
1 TemporarilyUnavailable O status de verificação não pode ser determinado no momento. O aplicativo pode tentar novamente mais tarde.
2 Unverified A idade do usuário não foi verificada.
3 OptedOut O usuário optou pela verificação por idade.
4 Verified A idade do usuário foi verificada.

NotApplicable e TemporarilyUnavailable não estabeleça que o usuário seja verificado ou não verificado. Manipule-os como estados separados.

  • 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.
  • 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 um status de verificação padrão por meio da Política de Grupo ou do MDM. Quando as APIs são desabilitadas, esse método retorna NotApplicable. Quando um status padrão é configurado, esse método retorna o valor ou configurado VerifiedUnverified .

Aplica-se a

Confira também