User.GetUserAgeRangeAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
userAccountInformationFunktion deklarieren. Ein Anrufer ohne Zugriff oder ein Anrufer, der einUserObjekt für einen anderen Benutzer verwendet, kann empfangenE_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 Sieco_awaitihn 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.