ICredentialProvider::Advise 方法 (credentialprovider.h)

允许凭据提供程序通过回调接口在登录 UI 或凭据 UI 中启动事件。

语法

HRESULT Advise(
  [in] ICredentialProviderEvents *pcpe,
  [in] UINT_PTR                  upAdviseContext
);

参数

[in] pcpe

类型: ICredentialProviderEvents*

指向要用作通知机制的 ICredentialProviderEvents 回调接口的指针。

[in] upAdviseContext

类型: UINT_PTR

指向整数的指针,该整数唯一标识哪个凭据提供程序已请求重新枚举。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

方法不需要实现,否则应返回 E_NOTIMPL 。 可能没有理由调用它,例如登录 UI 或凭据 UI 永远不会更改或更新。

此方法使登录 UI 和凭据 UI 能够将 ICredentialProviderEvents 指针传递到凭据提供程序。 这使凭据提供程序能够与登录或凭据 UI 进行异步回调通信。 例如,智能卡提供程序可能希望在插入新的智能卡时再次枚举凭据。 为了触发登录 UI 再次获取凭据,凭据提供程序应调用 CredentialsChanged ,提供 upAdviseContext 标识符。

实现此方法的凭据提供程序负责在提供的 ICredentialProviderEvents 上调用 AddRef。 这些凭据提供程序还需要在 UnAdvise 方法期间调用 Release

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 credentialprovider.h

另请参阅

ICredentialProvider

ICredentialProvider::UnAdvise