ICredentialProvider：：GetCredentialCount 方法 (credentialprovider.h)

获取此凭据提供程序下的可用凭据数。

语法

HRESULT GetCredentialCount(
  [out] DWORD *pdwCount,
  [out] DWORD *pdwDefault,
  [out] BOOL  *pbAutoLogonWithDefault
);

[out] pdwCount

类型： DWORD*

指向接收凭据计数的 DWORD 值的指针。

[out] pdwDefault

类型： DWORD*

指向 DWORD 值的指针，该值接收要用作默认值的凭据的索引。如果未设置默认值，则应将此值设置为 CREDENTIAL_PROVIDER_NO_DEFAULT。

[out] pbAutoLogonWithDefault

类型： BOOL*

指向 BOOL 值的指针，该值指示是否应使用 pdwDefault 标识的默认凭据进行自动登录尝试。自动登录尝试意味着登录 UI 或凭据 UI 将立即在提供程序的默认磁贴上调用 GetSerialization 。

类型： HRESULT

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

此方法是必需的。

当登录 UI 或凭据 UI 可供用户交互时，默认选择默认凭据。由于每个凭据提供程序都提供默认凭据，因此以下规则确定 pdwDefault 是否会接收焦点，或者是否会自动登录凭据。

如果有效凭据的数量发生更改，凭据提供程序应在建议中提供的 ICredentialProviderEvents 实例上调用 CredentialsChanged。

凭据提供程序处理极其敏感的用户机密，以便完成登录和解锁请求。最佳做法是，密码和 PIN 等机密信息应得到最谨慎的处理。在凭据提供程序中处理机密信息的适当技术包括：