Sprache

User.GetAgeVerificationStatusAsync Methode

Definition

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 userAccountInformation Funktion deklarieren. Ein Anrufer ohne Zugriff oder ein Anrufer, der ein User Objekt für einen anderen Benutzer verwendet, kann empfangen E_ACCESSDENIEDwerden.
  • 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 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.

Gilt für:

Siehe auch