UserInformation.GetPrincipalNameAsync 메서드

정의

네임스페이스:

Windows.System.UserProfile

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

중요

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

public:
 static IAsyncOperation<Platform::String ^> ^ GetPrincipalNameAsync();

/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Deprecated("Use User instead of UserInformation. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.System.UserProfile.UserProfileContract")]
 static IAsyncOperation<winrt::hstring> GetPrincipalNameAsync();

[Windows.Foundation.Metadata.RemoteAsync]
[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 IAsyncOperation<string> GetPrincipalNameAsync();

function getPrincipalNameAsync()

Public Shared Function GetPrincipalNameAsync () As IAsyncOperation(Of String)

반환

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

사용자의 보안 주체 이름입니다.

특성

RemoteAsyncAttribute DeprecatedAttribute

설명

중요

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

도메인 사용자만 보안 주체 이름을 갖습니다. 보안 주체 이름에 대한 액세스는 개인 정보 설정에 의해 차단될 수 있습니다(예: UserInformation.NameAccessAllowed 속성이 false인 경우). 액세스가 차단되면 이 메서드는 빈 문자열을 반환합니다.

이 메서드에는 enterpriseAuthentication 기능이 필요합니다.

이 메서드는 예외를 throw하지 않습니다.

추가 정보

• User