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 |