Lenguaje

User.GetAgeVerificationStatusAsync Método

Definición

Espacio de nombres:
Windows.System
Editar

Recupera un valor que indica si se ha comprobado la antigüedad del usuario actual y cómo se ha comprobado.

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)

Devoluciones

IAsyncOperation<UserAgeVerificationStatus>

Operación asincrónica que devuelve un valor UserAgeVerificationStatus para el usuario actual.

Atributos
RemoteAsyncAttribute

Requisitos de Windows

Requisitos Description
Familia de dispositivos
Windows 11, version 24H2 (se introdujo en la versión 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v19.0)
Características de aplicaciones
userAccountInformation

Ejemplos

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

Comentarios

En la tabla siguiente se describen los posibles valores devueltos.

Value Nombre Significado
0 NotApplicable La comprobación por edad no se aplica, no hay ninguna señal de verificación disponible o la característica no está disponible o deshabilitada.
1 TemporarilyUnavailable El estado de comprobación no se puede determinar actualmente. La aplicación puede volver a intentarlo más adelante.
2 Unverified No se ha comprobado la antigüedad del usuario.
3 OptedOut El usuario ha optado por no realizar la comprobación por edad.
4 Verified Se ha comprobado la antigüedad del usuario.

NotApplicable y TemporarilyUnavailable no establecen que el usuario se comprueba o no se comprueba. Controlarlos como estados independientes.

  • Llame a este método en el objeto User para el usuario que ejecuta el proceso actual. Use User.GetDefault para obtener ese usuario directamente.
  • El paquete de la aplicación debe declarar la userAccountInformation funcionalidad. Un autor de llamada sin acceso o un autor de llamada mediante un User objeto para un usuario diferente puede recibir E_ACCESSDENIED.
  • En C++/WinRT, llame .get() desde un subproceso que no sea de interfaz de usuario adecuado o use co_await desde una corrutina.

Directiva administrativa

Los administradores pueden deshabilitar las API de digital safety age o configurar un estado de comprobación predeterminado a través de la directiva de grupo o MDM. Cuando las API están deshabilitadas, este método devuelve NotApplicable. Cuando se configura un estado predeterminado, este método devuelve el valor configurado Verified o Unverified .

Se aplica a

Consulte también