Langue

User.GetAgeVerificationStatusAsync Méthode

Définition

Espace de noms:
Windows.System
Modifier

Récupère une valeur indiquant si et comment l’âge de l’utilisateur actuel a été vérifié.

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)

Retours

IAsyncOperation<UserAgeVerificationStatus>

Opération asynchrone qui retourne une valeur UserAgeVerificationStatus pour l’utilisateur actuel.

Attributs
RemoteAsyncAttribute

Configuration requise pour Windows

Configuration requise Description
Famille d’appareils
Windows 11, version 24H2 (introduit dans 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v19.0)
Fonctionnalités de l’application
userAccountInformation

Exemples

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

Remarques

Le tableau suivant décrit les valeurs de retour possibles.

Value Nom Sens
0 NotApplicable La vérification de l’âge ne s’applique pas, aucun signal de vérification n’est disponible, ou la fonctionnalité n’est pas disponible ou désactivée.
1 TemporarilyUnavailable L’état de vérification ne peut pas être déterminé actuellement. L’application peut réessayer ultérieurement.
2 Unverified L’âge de l’utilisateur n’a pas été vérifié.
3 OptedOut L’utilisateur a refusé la vérification de l’âge.
4 Verified L’âge de l’utilisateur a été vérifié.

NotApplicable et TemporarilyUnavailable n’établissez pas que l’utilisateur est vérifié ou non vérifié. Gérez-les en tant qu’états distincts.

  • Appelez cette méthode sur l’objet Utilisateur pour l’utilisateur exécutant le processus actuel. Utilisez User.GetDefault pour obtenir cet utilisateur directement.
  • Le package d’application doit déclarer la userAccountInformation fonctionnalité. Un appelant sans accès, ou un appelant à l’aide d’un User objet pour un autre utilisateur, peut recevoir E_ACCESSDENIED.
  • En C++/WinRT, appelez .get() à partir d’un thread non-interface utilisateur approprié ou utilisez co_await une coroutine.

Stratégie d’administration

Les administrateurs peuvent désactiver les API d’âge de sécurité numérique ou configurer un état de vérification par défaut via la stratégie de groupe ou mdm. Lorsque les API sont désactivées, cette méthode retourne NotApplicable. Lorsqu’un état par défaut est configuré, cette méthode retourne la valeur configurée ou Unverified la Verified valeur.

S’applique à

Voir aussi