UserInformation.GetPrincipalNameAsync 方法

定義

命名空間:

Windows.System.UserProfile

取得使用者的主體名稱。 此名稱是使用者主體名稱 (通常是使用者的位址，但這不是一定 true。)

重要

Windows 10或更新版本不支援UserInformation類別。 請改用 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

備註

重要

Windows 10或更新版本不支援UserInformation類別。 請改用 User 類別。 請參閱 UserInformation 類別檔中的。

只有網域使用者具有主體名稱。 例如，如果 UserInformation.NameAccessAllowed 屬性為 false) ，即可封鎖隱私權設定 (存取主體名稱。 如果存取遭到封鎖，這個方法會傳回空字串。

此方法需要 enterpriseAuthentication 功能。

這個方法不會擲回例外狀況。

另請參閱

• User