Share via

Метод ICredentialProviderEvents::CredentialsChanged (credentialprovider.h)

  • Статья

Сигнализирует пользовательскому интерфейсу входа или пользовательскому интерфейсу учетных данных об изменении перечисленного списка учетных данных. Это происходит при изменении количества учетных данных, изменении отдельных учетных данных или количестве доступных полей. Это асинхронный метод.

Синтаксис

HRESULT CredentialsChanged(
  [in] UINT_PTR upAdviseContext
);

Параметры

[in] upAdviseContext

Тип: UINT_PTR

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

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

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

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

Требования

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