IIdentityProvider::Advise 方法 (identityprovider.h)

建议方法允许调用应用程序指定要通知应用程序的标识事件列表。

语法

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

parameters

[in] pIdentityAdvise

指向由调用应用程序实现的 IIdentityAdvise 接口的指针。 此接口提供一个方法,当 dwIdentityUpdateEvents 参数指定的某个事件发生时,标识提供者可以调用该方法。

[in] dwIdentityUpdateEvents

要通知调用应用程序的标识事件。 此参数的值可以是使用按位 OR 运算组合的以下值的零个或多个值。

含义
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
标头 identityprovider.h

另请参阅

IIdentityAdvise::IdentityUpdated

IIdentityProvider