言語

User.GetUserAgeRangeAsync メソッド

定義

名前空間:
Windows.System
編集

現在のユーザーの対象となる年齢範囲を取得します。

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)

返品

IAsyncOperation<UserAgeRange>

現在の ユーザーの UserAgeRange を返す非同期操作。または、有効期間が不明または使用できない場合に null 。

属性
RemoteAsyncAttribute

Windows の要件

要件 説明
デバイス ファミリ
Windows 11, version 24H2 (10.0.26100.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v19.0 で導入)
アプリの機能
userAccountInformation

例

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

注釈

UserAgeRange.Lower と UserAgeRange.Upper は包括的な境界です。

年齢層 Lower Upper
10 以下 0 9
10-12 10 12
13-15 13 15
16-17 16 17
18 歳以上 18 INT32_MAX

この操作は、ユーザーの年齢が不明な場合、機能が使用できない場合、または API が管理ポリシーによって無効になっている場合に、 null を返します。 null結果は予想される結果であり、正確な年齢または 18 以前の範囲として扱う必要はありません。

  • 現在のプロセスを実行している ユーザーの User オブジェクトでこのメソッドを呼び出します。 User.GetDefault を使用して、そのユーザーを直接取得します。
  • アプリ パッケージでは、 userAccountInformation 機能を宣言する必要があります。 アクセス権のない呼び出し元、または別のユーザーの User オブジェクトを使用する呼び出し元は、 E_ACCESSDENIEDを受信できます。
  • このメソッドは、ユーザーの正確な年齢や生年月日ではなく、年齢バケットを返します。
  • C++/WinRT では、適切な非 UI スレッドから .get() を呼び出すか、コルーチンから co_await を使用します。

管理ポリシー

管理者は、デジタル安全性年齢 API を無効にしたり、グループ ポリシーまたは MDM を使用して既定の年齢グループを構成したりできます。 API が無効になっている場合、このメソッドは nullを返します。 既定の年齢グループが構成されている場合、このメソッドは、そのグループに対応する UserAgeRange を返します。

適用対象

こちらもご覧ください