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

  • Статья

Расширяет интерфейс ICredentialProviderCredentialEvents , добавляя методы, обеспечивающие пакетное обновление полей в пользовательском интерфейсе Журнала или пользовательском интерфейсе учетных данных.

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

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

Методы

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

 
ICredentialProviderCredentialEvents2::BeginFieldUpdates

Запускает пакетное обновление полей в пользовательском интерфейсе входа или учетных данных.
ICredentialProviderCredentialEvents2::EndFieldUpdates

Завершает и фиксирует пакетные обновления, запущенные BeginFieldUpdates.
ICredentialProviderCredentialEvents2::SetFieldOptions

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

Комментарии

В Windows 7 и Windows Vista многие поставщики учетных данных использовали ICredentialProviderEvents::CredentialsChanged для обновления пользовательского интерфейса. Хотя это работает, это приводит к повторному перечислению всех учетных данных из вызывающего поставщика учетных данных. Обработка этого события в некоторых случаях может привести к мигателям или изменениям фокуса в пользовательском интерфейсе из-за этого повторного перечисления. Поэтому использование ICredentialProviderEvents::CredentialsChanged исключительно для обновлений пользовательского интерфейса не рекомендуется. Новая рекомендация выглядит следующим образом:

  • Используйте ICredentialProviderEvents::CredentialsChanged только в том случае, если поставщик учетных данных должен автоматически входить в систему пользователя или изменять количество учетных данных, которые он перечисляет.
  • Используйте ICredentialProviderCredentialEvents2 для обновления пользовательского интерфейса поставщика учетных данных.
ICredentialProviderCredentialEvents2 включает все методы, унаследованные от ICredentialProviderCredentialEvents. Сюда входят все унаследованные методы, кроме OnCreatingWindow.

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

Когда следует реализовать

Сторонние разработчики не реализуют этот интерфейс. Вызовите метод QueryInterface в ICredentialProviderCredentialEvents , чтобы получить этот объект.

Требования

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

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

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

ICredentialProviderCredentialEvents