ICredentialProviderEvents::CredentialsChanged 方法 (credentialprovider.h)
指示登录 UI 或凭据 UI 的枚举凭据列表已更改。 当凭据数更改、单个凭据更改或可用字段数更改时,就会发生这种情况。 这是一种异步方法。
语法
HRESULT CredentialsChanged(
[in] UINT_PTR upAdviseContext
);
参数
[in] upAdviseContext
类型: UINT_PTR
指向整数的指针,该整数唯一标识哪个凭据提供程序已请求重新枚举。 凭据提供程序应在此参数中传递它从 建议 收到的接口指针。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
注解
过去,许多凭据提供程序使用 ICredentialProviderEvents::CredentialsChanged 更新 UI。 虽然这有效,但它会导致重新枚举来自调用凭据提供程序的所有凭据。 在某些情况下,由于这种重新枚举,此事件的处理可能会导致 UI 中的闪烁或焦点更改。 因此,不建议仅对 UI 更新使用 ICredentialProviderEvents::CredentialsChanged 。 新建议如下:
- 仅当凭据提供程序需要执行自动登录或更改其枚举的凭据数时,才使用 ICredentialProviderEvents::CredentialsChanged 。
- 使用 ICredentialProviderCredentialEvents2 更新凭据提供程序的登录 UI 或凭据 UI。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | credentialprovider.h |