Lingua

User.GetAgeVerificationStatusAsync Metodo

Definizione

Spazio dei nomi:
Windows.System
Modifica

Recupera un valore che indica se e come è stata verificata l'età dell'utente corrente.

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)

Valori restituiti

IAsyncOperation<UserAgeVerificationStatus>

Operazione asincrona che restituisce un valore UserAgeVerificationStatus per l'utente corrente.

Attributi
RemoteAsyncAttribute

Requisiti Windows

Requisiti Descrizione
Famiglia di dispositivi
Windows 11, version 24H2 (è stato introdotto in 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v19.0)
Funzionalità dell'app
userAccountInformation

Esempio

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

Commenti

Nella tabella seguente vengono descritti i possibili valori restituiti.

Value Nome Meaning
0 NotApplicable La verifica dell'età non si applica, non è disponibile alcun segnale di verifica o la funzionalità non è disponibile o disabilitata.
1 TemporarilyUnavailable Non è attualmente possibile determinare lo stato di verifica. L'app può riprovare in un secondo momento.
2 Unverified L'età dell'utente non è stata verificata.
3 OptedOut L'utente ha rifiutato esplicitamente la verifica dell'età.
4 Verified L'età dell'utente è stata verificata.

NotApplicable e TemporarilyUnavailable non stabilire che l'utente sia verificato o non verificato. Gestirli come stati separati.

  • Chiamare questo metodo sull'oggetto User per l'utente che esegue il processo corrente. Usare User.GetDefault per ottenere direttamente l'utente.
  • Il pacchetto dell'app deve dichiarare la userAccountInformation funzionalità. Un chiamante senza accesso o un chiamante che usa un User oggetto per un utente diverso può ricevere E_ACCESSDENIED.
  • In C++/WinRT chiamare .get() da un thread non dell'interfaccia utente appropriato o da co_await una coroutine.

Criteri amministrativi

Gli amministratori possono disabilitare le API digital safety age o configurare uno stato di verifica predefinito tramite Criteri di gruppo o MDM. Quando le API sono disabilitate, questo metodo restituisce NotApplicable. Quando viene configurato uno stato predefinito, questo metodo restituisce il valore o Unverified configuratoVerified.

Si applica a

Vedi anche