Интерфейс ICredentialProviderUserArray (credentialprovider.h)

Статья
08/22/2023

Представляет набор пользователей, которые будут отображаться в пользовательском интерфейсе входа или учетных данных. Эти сведения позволяют поставщику учетных данных перечислить набор для получения сведений о свойствах каждого пользователя для заполнения полей или фильтрации набора.

Наследование

Интерфейс ICredentialProviderUserArray наследуется от интерфейса IUnknown . ICredentialProviderUserArray также имеет следующие типы элементов:

Методы

Интерфейс ICredentialProviderUserArray содержит следующие методы.


ICredentialProviderUserArray::GetAccountOptions Извлекает значение, указывающее, отображается ли плитка "Другой пользователь" для локальных учетных записей или учетных записей Майкрософт в пользовательском интерфейсе входа или учетных данных.
ICredentialProviderUserArray::GetAt Извлекает указанного пользователя из массива.
ICredentialProviderUserArray::GetCount Извлекает количество объектов ICredentialProviderUser в пользовательском массиве.
ICredentialProviderUserArray::SetProviderFilter Ограничивает набор пользователей в массиве локальными учетными записями или учетными записями Майкрософт.

Этот объект предоставляется платформой поставщика учетных данных 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
Header	credentialprovider.h

См. также раздел

ICredentialProviderSetUserArray

ICredentialProviderUser

IUnknown

Поделиться через