Sdílet prostřednictvím


User.GetPropertiesAsync(IVectorView<String>) Method

Definition

Gets properties for the user.

public:
 virtual IAsyncOperation<IPropertySet ^> ^ GetPropertiesAsync(IVectorView<Platform::String ^> ^ values) = GetPropertiesAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<IPropertySet> GetPropertiesAsync(IVectorView<winrt::hstring> const& values);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<IPropertySet> GetPropertiesAsync(IReadOnlyList<string> values);
function getPropertiesAsync(values)
Public Function GetPropertiesAsync (values As IReadOnlyList(Of String)) As IAsyncOperation(Of IPropertySet)

Parameters

values

IVectorView<String>

IReadOnlyList<String>

IVectorView<Platform::String>

IVectorView<winrt::hstring>

The properties to get. Use the KnownUserProperties class to obtain property names.

Returns

When this method completes, it returns the requested properties. If a property is missing or unavailable, it is reported as an empty string.

Attributes

Windows requirements

App capabilities
userAccountInformation

Remarks

Not all properties are available for all users. The following table summarizes which properties are available under various conditions.

Property Local account not domain joined Local account domain joined MSA account AAD account
AccountName Not available Not available Not available Not available
DisplayName Not available Not available Not available Available if domain joined
DomainName Not available Available Not available Available
FirstName Available Available Available Available
GuestHost Available on XBOX Available on XBOX Available on XBOX Available on XBOX
LastName Available Available Available Available
PrincipalName Not available Available Not available Available if domain joined
ProviderName Not available Not available Not available Not available
SessionInitiationProtocolUri Not available Available Not available Available if domain joined

Applies to

See also