Метод ICredentialProvider::Advise (credentialprovider.h)
Позволяет поставщику учетных данных инициировать события в пользовательском интерфейсе входа или пользовательском интерфейсе учетных данных через интерфейс обратного вызова.
Синтаксис
HRESULT Advise(
[in] ICredentialProviderEvents *pcpe,
[in] UINT_PTR upAdviseContext
);
Параметры
[in] pcpe
Тип: ICredentialProviderEvents*
Указатель на интерфейс обратного вызова ICredentialProviderEvents , используемый в качестве механизма уведомлений.
[in] upAdviseContext
Тип: UINT_PTR
Указатель на целое число, однозначно определяющее, какой поставщик учетных данных запросил повторное перечисление.
Возвращаемое значение
Тип: HRESULT
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Метод не требуется реализовывать, и в противном случае он должен возвращать E_NOTIMPL . Это может не вызываться, например, если пользовательский интерфейс входа или пользовательский интерфейс учетных данных никогда не изменяется или не обновляется.
Этот метод позволяет пользовательскому интерфейсу входа и пользовательскому интерфейсу учетных данных передавать указатель ICredentialProviderEvents поставщику учетных данных. Это позволяет поставщику учетных данных осуществлять асинхронную связь обратного вызова с пользовательским интерфейсом входа или учетных данных. Например, поставщику смарт-карта может потребоваться повторно перечислить учетные данные при вставке нового смарт-карта. Чтобы снова активировать пользовательский интерфейс входа для получения учетных данных, поставщик учетных данных должен вызвать CredentialsChanged с идентификатором upAdviseContext .
Поставщики учетных данных, реализующие этот метод, несут ответственность за вызов AddRef для предоставленного объекта ICredentialProviderEvents. Эти поставщики учетных данных также должны вызывать Release во время метода UnAdvise .
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | credentialprovider.h |