User.GetUserAgeRangeAsync Metodo

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)

Valori restituiti

Operazione asincrona che restituisce un oggetto UserAgeRange per l'utente corrente o null quando l'intervallo di età è sconosciuto o non disponibile.

Attributi

RemoteAsyncAttribute

Requisiti Windows

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

Commenti

UserAgeRange.Lower e UserAgeRange.Upper sono limiti inclusivi.

L'operazione restituisce null quando l'età dell'utente non è nota, la funzionalità non è disponibile o le API sono disabilitate dai criteri amministrativi. Un null risultato è un risultato previsto e non deve essere considerato come un'età esatta o come intervallo di 18 o più vecchi.

• 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.
• Questo metodo restituisce un bucket di età, non l'età esatta o la data di nascita dell'utente.
• 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 un gruppo di età predefinito tramite Criteri di gruppo o MDM. Quando le API sono disabilitate, questo metodo restituisce null. Quando viene configurato un gruppo di età predefinito, questo metodo restituisce l'oggetto UserAgeRange corrispondente a tale gruppo.

Vedi anche

• User
• User.GetDefault
• User.FindAllAsync
• User.GetAgeVerificationStatusAsync
• UserAgeRange