UserInformation.GetPrincipalNameAsync UserInformation.GetPrincipalNameAsync UserInformation.GetPrincipalNameAsync UserInformation.GetPrincipalNameAsync UserInformation.GetPrincipalNameAsync Method

Definition

Gets the principal name for the user. This name is the User Principal Name (typically the user's address, although this is not always true.)

Important

The UserInformation class is not supported on Windows 10 or later. Use the User class instead. See Remarks in the UserInformation class documentation.

public : static IAsyncOperation<Platform::String> GetPrincipalNameAsync()
static IAsyncOperation<winrt::hstring> GetPrincipalNameAsync() const;
public static IAsyncOperation<string> GetPrincipalNameAsync()
Public Shared Function GetPrincipalNameAsync() As IAsyncOperation(Of string)
Windows.System.UserProfile.UserInformation.getPrincipalNameAsync().done( /* Your success and error handlers */ );
Returns

Remarks

Important

The UserInformation class is not supported on Windows 10 or later. Use the User class instead. See Remarks in the UserInformation class documentation.

Only domain users have a principal name. Access to the principal name can be blocked by privacy settings (for example, if the UserInformation::NameAccessAllowed property is false). If access is blocked, this method returns an empty string.

This method requires the enterpriseAuthentication capability.

This method does not throw an exception.

See Also