Langue

User.GetUserAgeRangeAsync Méthode

Définition

Espace de noms:
Windows.System
Modifier

Récupère la plage d’âge dans laquelle l’utilisateur actuel tombe.

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)

Retours

IAsyncOperation<UserAgeRange>

Opération asynchrone qui retourne un UserAgeRange pour l’utilisateur actuel, ou null lorsque la plage d’âge est inconnue ou indisponible.

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

Remarques

UserAgeRange.Lower et UserAgeRange.Upper sont des limites inclusives.

Tranche d’âge Lower Upper
Moins de 10 ans 0 9
10-12 10 12
13-15 13 15
16-17 16 17
18 ans ou plus 18 INT32_MAX

L’opération retourne null lorsque l’âge de l’utilisateur n’est pas connu, que la fonctionnalité n’est pas disponible ou que les API sont désactivées par la stratégie d’administration. Un null résultat est un résultat attendu et ne doit pas être traité comme un âge exact ou comme la plage de 18 ou plus.

  • 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.
  • Cette méthode retourne un compartiment d’âge, et non l’âge exact ou la date de naissance de l’utilisateur.
  • 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 groupe d’âge par défaut via la stratégie de groupe ou mdm. Lorsque les API sont désactivées, cette méthode retourne null. Lorsqu’un groupe d’âge par défaut est configuré, cette méthode retourne celle UserAgeRange qui correspond à ce groupe.

S’applique à

Voir aussi