언어

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

설명

다음 표에서는 가능한 반환 값에 대해 설명합니다.

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 .

관리 정책

관리자는 그룹 정책 또는 MDM을 통해 디지털 안전 기간 API를 사용하지 않도록 설정하거나 기본 확인 상태를 구성할 수 있습니다. API를 사용하지 않도록 설정하면 이 메서드가 반환됩니다 NotApplicable. 기본 상태가 구성되면 이 메서드는 구성된 Verified 값이나 Unverified 값을 반환합니다.

적용 대상

참고 항목