언어

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 요구 사항

요구 사항 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();
    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 합니다.

적용 대상

참고 항목