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

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

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

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

Методы

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

ICredentialProvider::Advise Позволяет поставщику учетных данных инициировать события в пользовательском интерфейсе входа или учетных данных через интерфейс обратного вызова.
ICredentialProvider::GetCredentialAt Возвращает определенные учетные данные.
ICredentialProvider::GetCredentialCount Возвращает количество доступных учетных данных в этом поставщике учетных данных.
ICredentialProvider::GetFieldDescriptorAt Возвращает метаданные, описывающие указанное поле.
ICredentialProvider::GetFieldDescriptorCount Извлекает количество полей в элементе , необходимом для отображения учетных данных этого поставщика.
ICredentialProvider::SetSerialization Задает характеристики сериализации поставщика учетных данных.
ICredentialProvider::SetUsageScenario Определяет сценарии, для которых является допустимым поставщик учетных данных. Вызывается при инициализации поставщика учетных данных.
ICredentialProvider::UnAdvise Используется в пользовательском интерфейсе входа или пользовательском интерфейсе учетных данных, чтобы сообщить поставщику учетных данных о том, что обратные вызовы событий больше не принимаются.

Комментарии

В этом интерфейсе вы будете взаимодействовать с пользовательским интерфейсом входа и пользовательским интерфейсом учетных данных для приложения.

Поставщик экземпляров учетных данных поддерживается в течение всего времени существования пользовательского интерфейса входа. Поэтому пользовательский интерфейс входа может поддерживать состояние поставщика учетных данных. В частности, он запоминает, какой поставщик и плитка предоставили учетные данные. Это означает, что вы можете хранить сведения о состоянии при использовании CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_LOGON, CPUS_UNLOCK_WORKSTATION и CPUS_CHANGE_PASSWORD. Это не относится к пользовательскому интерфейсу учетных данных. Пользовательский интерфейс учетных данных создает новый экземпляр поставщика каждый раз, когда приложение вызывает CredUIPromptForWindowsCredentials. Из-за этого пользовательский интерфейс учетных данных не может запомнить состояние поставщика учетных данных.

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

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

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	credentialprovider.h

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

CREDENTIAL_PROVIDER_USAGE_SCENARIO

Интерфейс входа Windows на основе поставщика учетных данных

Поставщики учетных данных в Windows 10

ICredentialProviderCredential