ICredentialProvider 接口 (credentialprovider.h)
公开在凭据提供程序的设置和操作中使用的方法。 所有凭据提供程序都必须实现此接口。
继承
ICredentialProvider 接口继承自 IUnknown 接口。 ICredentialProvider 还具有以下类型的成员:
方法
ICredentialProvider 接口具有以下方法。
ICredentialProvider::Advise 允许凭据提供程序通过回调接口在登录 UI 或凭据 UI 中启动事件。 |
ICredentialProvider::GetCredentialAt 获取特定凭据。 |
ICredentialProvider::GetCredentialCount 获取此凭据提供程序下的可用凭据数。 |
ICredentialProvider::GetFieldDescriptorAt 获取描述指定字段的元数据。 |
ICredentialProvider::GetFieldDescriptorCount 检索显示此提供程序凭据所需的 中的字段计数。 |
ICredentialProvider::SetSerialization 设置凭据提供程序的序列化特征。 |
ICredentialProvider::SetUsageScenario 定义凭据提供程序有效的方案。 每当初始化凭据提供程序时调用。 |
ICredentialProvider::UnAdvise 登录 UI 或凭据 UI 用于通知凭据提供程序不再接受事件回调。 |
备注
此接口是你将如何与应用的登录 UI 和凭据 UI 进行交互。
实例化凭据提供程序在登录 UI 的整个生存期内维护。 因此,登录 UI 可以维护凭据提供程序的状态。 具体而言,它会记住哪个提供程序和磁贴提供了凭据。 这意味着,在使用CREDENTIAL_PROVIDER_USAGE_SCENARIO CPUS_LOGON、CPUS_UNLOCK_WORKSTATION和CPUS_CHANGE_PASSWORD时,可能会存储状态信息。 凭据 UI 的情况并非如此。 每次应用程序调用 CredUIPromptForWindowsCredentials 时,凭据 UI 都会创建提供程序的新实例。 因此,凭据 UI 无法记住凭据提供程序的状态。
请注意,在一个方案中生成的 CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION 可能会保存并在后续使用方案中使用。 因此,有必要确保 ICredentialProvider 实现足够可靠,能够处理此方案。
Windows 8 在凭据提供程序 API 中添加了新功能,主要是按用户对凭据进行分组的功能。
要求
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | credentialprovider.h |