User.GetPropertiesAsync(IVectorView<String>) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取用户的属性。
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)
参数
- values
-
IVectorView<Platform::String>
IVectorView<winrt::hstring>
要获取的属性。 使用 KnownUserProperties 类获取属性名称。
返回
此方法完成后,它将返回请求的属性。 如果属性缺失或不可用,则会将其报告为空字符串。
- 属性
Windows 要求
| 应用功能 |
userAccountInformation
|
注解
并非所有属性都适用于所有用户。 下表汇总了在各种条件下可用的属性。
| 属性 | 未加入域的本地帐户 | 已加入本地帐户域 | MSA 帐户 | AAD 帐户 |
|---|---|---|---|---|
| AccountName | 不可用 | 不可用 | 不可用 | 不可用 |
| DisplayName | 不可用 | 不可用 | 不可用 | 加入域后可用 |
| DomainName | 不可用 | 可用 | 不可用 | 可用 |
| FirstName | 可用 | 可用 | 可用 | 可用 |
| GuestHost | 在 XBOX 上可用 | 在 XBOX 上可用 | 在 XBOX 上可用 | 在 XBOX 上可用 |
| LastName | 可用 | 可用 | 可用 | 可用 |
| 主体名称 | 不可用 | 可用 | 不可用 | 加入域后可用 |
| ProviderName | 不可用 | 不可用 | 不可用 | 不可用 |
| SessionInitiationProtocolUri | 不可用 | 可用 | 不可用 | 加入域后可用 |