言語

User.GetAgeVerificationStatusAsync メソッド

定義

名前空間:
Windows.System
編集

現在のユーザーの年齢が検証されたかどうかを示す値を取得します。

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)

返品

IAsyncOperation<UserAgeVerificationStatus>

現在の ユーザーの UserAgeVerificationStatus 値を返す非同期操作。

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

注釈

次の表では、可能な戻り値について説明します。

Value 名前 Meaning
0 NotApplicable 年齢確認は適用されません。確認シグナルが使用できないか、機能が使用できないか無効になっています。
1 TemporarilyUnavailable 現在、確認の状態を確認できません。 アプリは後で再試行できます。
2 Unverified ユーザーの年齢が検証されていません。
3 OptedOut ユーザーが年齢確認をオプトアウトしました。
4 Verified ユーザーの年齢が確認されました。

NotApplicable TemporarilyUnavailableは、ユーザーが検証済みまたは未確認であることを確認しません。 それらを個別の状態として処理します。

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

管理ポリシー

管理者は、デジタルセーフティ年齢 API を無効にしたり、グループ ポリシーまたは MDM を使用して既定の検証状態を構成したりできます。 API が無効になっている場合、このメソッドは NotApplicableを返します。 既定の状態が構成されている場合、このメソッドは構成された Verified または Unverified 値を返します。

適用対象

こちらもご覧ください