語言

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 需求

規格需求 Description
裝置系列
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;
}

備註

下表說明可能的回傳值。

價值 名稱 Meaning
0 NotApplicable 年齡驗證不適用、沒有驗證訊號可用，或是此功能無法使用或停用。
1 TemporarilyUnavailable 目前無法確定驗證狀態。 應用程式可以稍後重試。
2 Unverified 用戶年齡尚未被驗證。
3 OptedOut 使用者已選擇不進行年齡驗證。
4 Verified 用戶年齡已驗證。

NotApplicable 也 TemporarilyUnavailable 不要說使用者是已驗證或未驗證。 把它們當作獨立的州來處理。

  • 在執行當前程序的 使用者 物件中呼叫此方法。 使用 User.GetDefault 直接取得該使用者。
  • 應用程式套件必須宣告該 userAccountInformation 功能。 沒有存取權的呼叫者，或使用 User 不同使用者物件的呼叫者，可以接收 E_ACCESSDENIED。
  • 在 C++/WinRT 中，從合適的非 UI 執行緒呼叫 .get() ，或從協程中使用 co_await 。

行政政策

管理員可停用數位安全時代 API，或透過群組政策或 MDM 設定預設驗證狀態。 當 API 被停用時，此方法會回傳 NotApplicable。 當預設狀態被設定時，此方法會回傳配置 Verified 或 Unverified 值。

適用於

另請參閱