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