Bahasa

User.GetAgeVerificationStatusAsync Metode

Definisi

Ruang nama:
Windows.System
Edit

Mengambil nilai yang menunjukkan apakah dan bagaimana usia pengguna saat ini telah diverifikasi.

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)

Mengembalikan

IAsyncOperation<UserAgeVerificationStatus>

Operasi asinkron yang mengembalikan nilai UserAgeVerificationStatus untuk pengguna saat ini.

Atribut
RemoteAsyncAttribute

Persyaratan Windows

Persyaratan Deskripsi
Rangkaian perangkat
Windows 11, version 24H2 (diperkenalkan dalam 10.0.26100.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v19.0)
Kemampuan aplikasi
userAccountInformation

Contoh

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

Keterangan

Tabel berikut ini menjelaskan kemungkinan nilai yang dikembalikan.

Nilai Nama Meaning
0 NotApplicable Verifikasi usia tidak berlaku, tidak ada sinyal verifikasi yang tersedia, atau fitur tidak tersedia atau dinonaktifkan.
1 TemporarilyUnavailable Status verifikasi saat ini tidak dapat ditentukan. Aplikasi dapat mencoba kembali nanti.
2 Unverified Usia pengguna belum diverifikasi.
3 OptedOut Pengguna telah menolak verifikasi usia.
4 Verified Usia pengguna telah diverifikasi.

NotApplicable dan TemporarilyUnavailable tidak menetapkan bahwa pengguna diverifikasi atau tidak diverifikasi. Tangani sebagai status terpisah.

  • Panggil metode ini pada objek Pengguna untuk pengguna yang menjalankan proses saat ini. Gunakan User.GetDefault untuk mendapatkan pengguna tersebut secara langsung.
  • Paket aplikasi harus mencantumkan kapabilitas userAccountInformation. Penelepon tanpa akses, atau pemanggil yang User menggunakan objek untuk pengguna lain, dapat menerima E_ACCESSDENIED.
  • Di C++/WinRT, panggil .get() dari utas non-UI yang sesuai atau gunakan co_await dari coroutine.

Kebijakan administratif

Administrator dapat menonaktifkan API usia Keamanan Digital atau mengonfigurasi status verifikasi default melalui Kebijakan Grup atau MDM. Ketika API dinonaktifkan, metode ini mengembalikan NotApplicable. Ketika status default dikonfigurasi, metode ini mengembalikan nilai atau Unverified yang dikonfigurasiVerified.

Berlaku untuk

Lihat juga