UserInformation.GetPrincipalNameAsync 方法

定义

获取用户的主体名称。 此名称通常是用户地址 (用户主体名称,但并非始终如此。)

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的备注。

public:
 static IAsyncOperation<Platform::String ^> ^ GetPrincipalNameAsync();
/// [Windows.Foundation.Metadata.RemoteAsync]
 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")]
 static IAsyncOperation<winrt::hstring> GetPrincipalNameAsync();
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<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")]
public static IAsyncOperation<string> GetPrincipalNameAsync();
function getPrincipalNameAsync()
Public Shared Function GetPrincipalNameAsync () As IAsyncOperation(Of String)

返回

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

用户的主体名称。

属性

注解

重要

Windows 10 或更高版本不支持 UserInformation 类。 请改用 User 类。 请参阅 UserInformation 类文档中的备注。

只有域用户具有主体名称。 隐私设置可以阻止对主体名称的访问 (例如,如果 UserInformation.NameAccessAllowed 属性为 false) 。 如果访问被阻止,此方法将返回一个空字符串。

此方法需要 enterpriseAuthentication 功能。

此方法不会引发异常。

适用于

另请参阅