Sprache

User.GetUserAgeRangeAsync Methode

Definition

Ruft den Altersbereich ab, in den der aktuelle Benutzer fällt.

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)

Gibt zurück

Ein asynchroner Vorgang, der einen UserAgeRange für den aktuellen Benutzer zurückgibt oder null wenn der Altersbereich unbekannt oder nicht verfügbar ist.

Attribute

Windows-Anforderungen

Anforderungen Beschreibung
Gerätefamilie
Windows 11, version 24H2 (eingeführt in 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v19.0)
App-Funktionen
userAccountInformation

Beispiele

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

Hinweise

UserAgeRange.Lower und UserAgeRange.Upper sind inklusive Grenzen.

Altersgruppe Lower Upper
Unter 10 0 9
10-12 10 12
13-15 13 15
16-17 16 17
18 oder älter 18 INT32_MAX

Der Vorgang gibt zurück null , wenn das Alter des Benutzers nicht bekannt ist, das Feature nicht verfügbar ist oder die APIs durch administrative Richtlinien deaktiviert werden. Ein Ergebnis ist ein erwartetes null Ergebnis und darf nicht als genaues Alter oder als 18-älteren Bereich behandelt werden.

  • Rufen Sie diese Methode für das User-Objekt für den Benutzer auf, der den aktuellen Prozess ausführt. Verwenden Sie User.GetDefault , um diesen Benutzer direkt abzurufen.
  • Das App-Paket muss die userAccountInformation Funktion deklarieren. Ein Anrufer ohne Zugriff oder ein Anrufer, der ein User Objekt für einen anderen Benutzer verwendet, kann empfangen E_ACCESSDENIEDwerden.
  • Diese Methode gibt einen Alters-Bucket zurück, nicht das genaue Alter oder das Geburtsdatum des Benutzers.
  • Rufen Sie .get() in C++/WinRT von einem geeigneten Nicht-UI-Thread auf, oder verwenden Sie co_await ihn aus einem Coroutine.

Administrative Richtlinie

Administratoren können die ApIs für digitale Sicherheit deaktivieren oder eine Standardaltersgruppe über Gruppenrichtlinien oder MDM konfigurieren. Wenn die APIs deaktiviert sind, gibt diese Methode zurück null. Wenn eine Standardaltersgruppe konfiguriert ist, gibt diese Methode die UserAgeRange dieser Gruppe entspricht.

Gilt für:

Siehe auch