ICredentialProviderCredential 接口 (credentialprovider.h)

公开启用凭据处理的方法。

继承

ICredentialProviderCredential 接口继承自 IUnknown 接口。 ICredentialProviderCredential 还具有以下类型的成员：

方法

ICredentialProviderCredential 接口具有以下方法。

ICredentialProviderCredential：：Advise 允许凭据通过回调接口在登录 UI 或凭据 UI 中启动事件。 应在 ICredentialProviderCredential 接口中的其他方法之前调用此方法。
ICredentialProviderCredential：：CommandLinkClicked 启用登录 UI 和凭据 UI 以指示已单击链接。
ICredentialProviderCredential：：GetBitmapValue 允许从具有位图字段的凭据检索位图数据。
ICredentialProviderCredential：：GetCheckboxValue 检索复选框值。
ICredentialProviderCredential：：GetComboBoxValueAt 获取给定索引处的组合框条目的字符串标签。
ICredentialProviderCredential：：GetComboBoxValueCount 获取指定组合框中项的计数，并指定应具有初始选择的项。
ICredentialProviderCredential：：GetFieldState 检索字段状态。 登录 UI 和凭据 UI 使用此来获取有关凭据字段的信息，以在用户磁贴中显示此信息。
ICredentialProviderCredential：：GetSerialization 调用以响应尝试将此凭据提交到基础身份验证引擎。
ICredentialProviderCredential：：GetStringValue 允许从具有文本字段的凭据中检索文本。
ICredentialProviderCredential：：GetSubmitButtonValue 检索字段的标识符，提交按钮应放置在登录 UI 中的 旁边。
ICredentialProviderCredential：：ReportResult 将收到的错误状态代码转换为相应的用户可读消息。
ICredentialProviderCredential：：SetCheckboxValue 启用登录 UI 和凭据 UI 以指示复选框值已更改。
ICredentialProviderCredential：：SetComboBoxSelectedValue 启用登录 UI 和凭据 UI 以指示已选择组合框值。
ICredentialProviderCredential：：SetDeselected 当凭据失去选择时调用。
ICredentialProviderCredential：：SetSelected 在选择凭据时调用。 使实现者能够设置登录特征。
ICredentialProviderCredential：：SetStringValue 使登录 UI 或凭据 UI 能够在用户键入字段时更新CPFT_EDIT_TEXT字段的文本。
ICredentialProviderCredential：：UnAdvise 由登录 UI 或凭据 UI 用来通知凭据不再接受事件回调。

注解

何时实现

ICredentialProviderCredential 由提供用户凭据的登录 UI 或凭据 UI 的外部方实现。 如果没有此接口的实现，则无法枚举用户磁贴。

凭据提供程序最佳做法

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

• 始终安全地放弃机密。 为此，请在释放用于保存任何机密的内存之前调用 SecureZeroMemory 。
• 使用机密后，请立即安全丢弃机密。
• 如果机密未在预期时间内用于预期目的，请安全地丢弃机密。

要求

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

另请参阅

Windows 10 中的凭据提供程序

ICredentialProvider