Интерфейс 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 на основе поставщика учетных данных