다음을 통해 공유

UserInformation 클래스

  • 참조

정의

네임스페이스:
Windows.System.UserProfile
편집

이름 및 계정 그림과 같은 사용자에 대한 정보를 나타냅니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. 설명 부분을 참조하세요.

public ref class UserInformation abstract sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.System.UserProfile.UserProfileContract, 65536)]
class UserInformation final
/// [Windows.Foundation.Metadata.ContractVersion(Windows.System.UserProfile.UserProfileContract, 65536)]
/// [Windows.Foundation.Metadata.Deprecated("Use User instead of UserInformation. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.System.UserProfile.UserProfileContract")]
class UserInformation final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.System.UserProfile.UserProfileContract), 65536)]
public static class UserInformation
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.System.UserProfile.UserProfileContract), 65536)]
[Windows.Foundation.Metadata.Deprecated("Use User instead of UserInformation. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.System.UserProfile.UserProfileContract")]
public static class UserInformation
Public Class UserInformation
상속
Object Platform::Object IInspectable UserInformation
특성
ContractVersionAttribute DeprecatedAttribute

Windows 요구 사항

디바이스 패밀리
Windows Desktop Extension SDK (10.0.10240.0에서 도입되었습니다.)
 Windows Mobile Extension SDK (10.0.10240.0에서 도입되었습니다.)
API contract
Windows.System.UserProfile.UserProfileContract (v1.0에서 도입되었습니다.)

예제

function getUserInfo() {
    image = Windows.System.UserProfile.UserInformation.getAccountPicture(Windows.System.UserProfile.AccountPictureKind.smallImage);
    imageURL = URL.createObjectURL(image, false);
}

설명

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다.

Windows 10 UserInformation 클래스를 사용하는 Windows 8용으로 컴파일된 앱은 Windows 10 실행할 때 더 이상 사용자 정보를 반환하지 않습니다. Windows 10 앱은 이 권한이 기본적으로 부여되는 Windows 8과 달리 명시적 사용자 동의 없이는 사용자 정보에 액세스할 수 없기 때문입니다.

UserInformation 클래스를 사용하는 Windows 8 앱이 있는 경우 앱을 유니버설 Windows 플랫폼(UWP)로 마이그레이션하고 대신 User 클래스에 액세스해야 합니다. 사용자 정보에 액세스하는 UWP(유니버설 Windows 플랫폼) 앱은 이제 새 기능인 uap:userAccountInformation을 선언하고 새 API인 Windows.System.User.FindAllAsync 및 User.GetPropertiesAsync를 호출하여 데이터를 가져올 것으로 예상됩니다.

사용자가 앱을 설치하면 사용자 정보에 대한 액세스를 허용하라는 메시지가 표시됩니다. 사용자가 앱에서 정보에 액세스할 수 있도록 허용하면 앱이 Windows 10 설정 UI(설정>개인 정보계정 정보)의 개인 정보> 페이지에 나열됩니다. 이렇게 하면 Windows 10 사용자가 앱별로 사용자 정보에 액세스할 수 있습니다.

또한 비즈니스 및 엔터프라이즈 고객에게 특히 유용한 그룹 정책 변경을 배포하여 추가 코드 수정 없이 사용자 정보에 액세스할 수 있습니다. Windows 10 대한 사용자 정보에 대한 액세스를 허용하려면 다음 그룹 정책 설정을 사용하도록 설정하고 "Always On"로 설정합니다. 컴퓨터 구성 > 관리 템플릿 > 시스템 > 사용자 프로필 > 사용자 관리 사용자 관리(데스크톱 앱 아님)와 사용자 이름, 계정 사진 및 도메인 정보를 공유합니다. 자세한 내용은 Windows 및 Windows Server에 대한 그룹 정책 설정 참조를 다운로드합니다.

Windows 8 계정 사진 모드에서 시작하고 추가 프롬프트 없이 사용자의 사진을 설정하려면 앱 매니페스트의 확장 섹션에 다음을 포함하여 앱이 계정 사진 공급자로 등록해야 합니다.

속성

AccountPictureChangeEnabled

사용자의 계정 사진을 변경할 수 있는지 여부를 결정합니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
NameAccessAllowed

앱에서 사용자의 정보에 액세스할 수 있는지 확인할 수 있습니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.

메서드

GetAccountPicture(AccountPictureKind)

사용자의 계정 사진을 가져옵니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
GetDisplayNameAsync()

사용자 계정의 표시 이름을 가져옵니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
GetDomainNameAsync()

사용자의 도메인 이름을 가져옵니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
GetFirstNameAsync()

사용자의 이름을 가져옵니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
GetLastNameAsync()

사용자의 성을 가져옵니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
GetPrincipalNameAsync()

사용자의 보안 주체 이름을 가져옵니다. 이 이름은 사용자 계정 이름입니다(일반적으로 사용자의 주소이지만 항상 그렇지는 않습니다.)

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
GetSessionInitiationProtocolUriAsync()

사용자에 대한 세션 시작 프로토콜의 URI(Uniform Resource Identifier)를 가져옵니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
SetAccountPictureAsync(IStorageFile)

IStorageFile 개체를 사용하여 사용자 계정에 대한 그림을 설정합니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
SetAccountPictureFromStreamAsync(IRandomAccessStream)

IRandomAccessStream 개체를 사용하여 사용자 계정에 대한 그림을 설정합니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
SetAccountPicturesAsync(IStorageFile, IStorageFile, IStorageFile)

IStorageFile 개체를 사용하여 사용자 계정의 그림을 설정합니다. 작은 이미지, 큰 이미지 및 비디오 추가를 지원합니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.
SetAccountPicturesFromStreamsAsync(IRandomAccessStream, IRandomAccessStream, IRandomAccessStream)

IRandomAccessStream 개체를 사용하여 사용자 계정의 그림을 설정합니다. 작은 이미지, 큰 이미지 및 비디오 추가를 지원합니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.

이벤트

AccountPictureChanged

사용자의 이미지 또는 이름이 변경되면 발생합니다.

중요

UserInformation 클래스는 Windows 10 이상에서 지원되지 않습니다. 대신 User 클래스를 사용합니다. UserInformation 클래스 설명서의 설명을 참조하세요.

적용 대상

추가 정보