User.GetAgeVerificationStatusAsync 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 einen Wert ab, der angibt, ob und wie das Alter des aktuellen Benutzers überprüft wurde.
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)
Gibt zurück
Ein asynchroner Vorgang, der einen UserAgeVerificationStatus-Wert für den aktuellen Benutzer zurückgibt.
- 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();
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;
}
Hinweise
In der folgenden Tabelle werden die möglichen Rückgabewerte beschrieben.
| Wert | Name | Meaning |
|---|---|---|
| 0 | NotApplicable |
Die Altersüberprüfung gilt nicht, es ist kein Überprüfungssignal verfügbar, oder das Feature ist nicht verfügbar oder deaktiviert. |
| 1 | TemporarilyUnavailable |
Der Überprüfungsstatus kann derzeit nicht ermittelt werden. Die App kann später erneut versuchen. |
| 2 | Unverified |
Das Alter des Benutzers wurde nicht überprüft. |
| 3 | OptedOut |
Der Benutzer hat die Altersüberprüfung deaktiviert. |
| 4 | Verified |
Das Alter des Benutzers wurde überprüft. |
NotApplicable und TemporarilyUnavailable stellen Sie nicht fest, dass der Benutzer überprüft oder nicht überprüft wird. Behandeln Sie sie als separate Zustände.
- 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. - 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 Digital Safety Age APIs deaktivieren oder einen Standardüberprüfungsstatus über Gruppenrichtlinien oder MDM konfigurieren. Wenn die APIs deaktiviert sind, gibt diese Methode zurück NotApplicable. Wenn ein Standardstatus konfiguriert ist, gibt diese Methode den konfigurierten Verified oder Unverified Wert zurück.