Bahasa

User.GetUserAgeRangeAsync Metode

Definisi

Ruang nama:
Windows.System
Edit

Mengambil rentang usia tempat pengguna saat ini berada.

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)

Mengembalikan

IAsyncOperation<UserAgeRange>

Operasi asinkron yang mengembalikan UserAgeRange untuk pengguna saat ini, atau null ketika rentang usia tidak diketahui atau tidak tersedia.

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();
    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.
}

Keterangan

UserAgeRange.Lower dan UserAgeRange.Upper adalah batas-batas inklusif.

Kelompok usia Lower Upper
Di bawah 10 0 9
10-12 10 12
13-15 13 15
16-17 16 17
18 atau lebih lama 18 INT32_MAX

Operasi kembali null ketika usia pengguna tidak diketahui, fitur tidak tersedia, atau API dinonaktifkan oleh kebijakan administratif. null Hasilnya adalah hasil yang diharapkan dan tidak boleh diperlakukan sebagai usia yang tepat atau sebagai rentang 18 atau lebih tua.

  • 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.
  • Metode ini mengembalikan wadah usia, bukan usia atau tanggal lahir pengguna yang tepat.
  • 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 grup usia default melalui Kebijakan Grup atau MDM. Ketika API dinonaktifkan, metode ini mengembalikan null. Saat grup usia default dikonfigurasi, metode ini mengembalikan yang sesuai dengan grup tersebut UserAgeRange .

Berlaku untuk

Lihat juga