Метод IIdentityProvider::Advise (identityprovider.h)

Статья
08/24/2023

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

Синтаксис

HRESULT Advise(
  [in]  IIdentityAdvise *pIdentityAdvise,
  [in]  DWORD           dwIdentityUpdateEvents,
  [out] DWORD           *pdwCookie
);

Параметры

[in] pIdentityAdvise

Указатель на интерфейс IIdentityAdvise , реализованный вызывающим приложением. Этот интерфейс предоставляет метод, который поставщик удостоверений может вызывать при возникновении одного из событий, указанных параметром dwIdentityUpdateEvents .

[in] dwIdentityUpdateEvents

События удостоверений, о которых уведомляется вызывающее приложение. Значение этого параметра может быть равно нулю или больше из следующих значений, объединенных с помощью побитовой операции ИЛИ .

Значение	Значение
IDENTITY_ASSOCIATED 0X0001	Удостоверение было связано с поставщиком удостоверений.
IDENTITY_DISASSOCIATED 0X0002	Удостоверение было отвязано от поставщика удостоверений.
IDENTITY_CREATED 0X0004	Было создано новое удостоверение.
IDENTITY_IMPORTED 0X0008	Удостоверение было импортировано из другого поставщика удостоверений.
IDENTITY_DELETED 0X0010	Удостоверение было удалено из хранилища удостоверений.
IDENTITY_PROPCHANGE 0X0020	Изменено значение свойства удостоверения.

[out] pdwCookie

Указатель на значение, идентифицирующее это соединение. Завершив использование этого подключения, удалите его, передав это значение в метод UnAdvise .

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

Если метод завершается успешно, он возвращает S_OK.

Если происходит сбой метода, он возвращает код ошибки. Список распространенных кодов ошибок см. в разделе Общие значения HRESULT.

Требования


Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	identityprovider.h

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

IIdentityAdvise::IdentityUpdated

IIdentityProvider

Поделиться через