Метод 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 .

Требования

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

ICredentialProvider

ICredentialProvider::UnAdvise