UserInformation.GetPrincipalNameAsync Méthode

Définition

Espace de noms:

Windows.System.UserProfile

Obtient le nom principal de l’utilisateur. Ce nom est le nom d’utilisateur principal (généralement l’adresse de l’utilisateur, bien que ce ne soit pas toujours vrai).)

Important

La classe UserInformation n’est pas prise en charge sur Windows 10 ou version ultérieure. Utilisez la classe User à la place. Consultez Remarques dans la documentation de la 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)

Retours

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

Nom principal de l’utilisateur.

Attributs

RemoteAsyncAttribute DeprecatedAttribute

Remarques

Important

La classe UserInformation n’est pas prise en charge sur Windows 10 ou version ultérieure. Utilisez la classe User à la place. Consultez Remarques dans la documentation de la classe UserInformation .

Seuls les utilisateurs du domaine ont un nom de principal. L’accès au nom principal peut être bloqué par les paramètres de confidentialité (par exemple, si la propriété UserInformation.NameAccessAllowed a la valeur false). Si l’accès est bloqué, cette méthode retourne une chaîne vide.

Cette méthode nécessite la fonctionnalité enterpriseAuthentication .

Cette méthode ne lève pas d’exception.

Voir aussi

• User