UserInformation.GetPrincipalNameAsync Método

Definição

Namespace:

Windows.System.UserProfile

Obtém o nome principal do usuário. Esse nome é o Nome Principal do Usuário (normalmente o endereço do usuário, embora isso nem sempre seja verdadeiro.)

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe 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)

Retornos

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

O nome principal do usuário.

Atributos

RemoteAsyncAttribute DeprecatedAttribute

Comentários

Importante

Não há suporte para a classe UserInformation no Windows 10 ou posterior. Em vez disso, use a classe User . Consulte Comentários na documentação da classe UserInformation .

Somente os usuários de domínio têm um nome de entidade de segurança. O acesso ao nome principal pode ser bloqueado por configurações de privacidade (por exemplo, se a propriedade UserInformation.NameAccessAllowed for false). Se o acesso estiver bloqueado, esse método retornará uma cadeia de caracteres vazia.

Esse método requer a funcionalidade enterpriseAuthentication .

Esse método não gera uma exceção.

Confira também

• User