ICredentialProviderUserArray 接口 (credentialprovider.h)

表示将在登录或凭据 UI 中显示的用户集。 此信息使凭据提供程序能够枚举集，以检索有关每个用户的属性信息，以填充字段或筛选集。

继承

ICredentialProviderUserArray 接口继承自 IUnknown 接口。 ICredentialProviderUserArray 也具有以下类型的成员：

方法

ICredentialProviderUserArray 接口具有这些方法。

ICredentialProviderUserArray：：GetAccountOptions 检索一个值，该值指示本地帐户或 Microsoft 帐户的“其他用户”磁贴是否显示在登录或凭据 UI 中。
ICredentialProviderUserArray：：GetAt 从数组中检索指定用户。
ICredentialProviderUserArray：：GetCount 检索用户数组中的 ICredentialProviderUser 对象数。
ICredentialProviderUserArray：：SetProviderFilter 将数组中的用户集限制为本地帐户或 Microsoft 帐户。

注解

此对象由 Windows 凭据提供程序框架通过 ICredentialProviderSetUserArray：：SetUserArray 方法提供给凭据提供程序。 此对象的所有权仍由凭据提供程序框架拥有。

何时实现

第三方不实现此接口。 Windows 包含一个实现。

示例

以下示例演示了使用此接口的一些方法的方案。 变量 pcpua 表示以前声明的 ICredentialProviderUserArray 对象。

DWORD dwCount = 0;

HRESULT hr = pcpua->GetCount(&dwCount);

if (SUCCEEDED(hr))
{
    for (DWORD i = 0; i < dwCount; i++)
    {
        ICredentialProviderUser *pcpu = NULL;
        hr = pcpua->GetAt(i, &pcpu);

        if (SUCCEEDED(hr))
        {
            PWSTR pszName = NULL;
            hr = pcpu->GetStringValue(PKEY_Identity_UserName, &pszName);

            if (SUCCEEDED(hr))
            {
                // Do something with the string
                CoTaskMemFree(pszName);
            }
            pcpu->Release();
        }
    }
}

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
目标平台	Windows
标头	credentialprovider.h

另请参阅

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown