ICredentialProviderCredential2 接口 (credentialprovider.h)

  • 项目

通过添加检索用户的安全标识符 (SID) 的方法，扩展 ICredentialProviderCredential 接口。 凭据与该用户关联，可以在用户的磁贴下分组。

继承

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

方法

ICredentialProviderCredential2 接口具有这些方法。

 
ICredentialProviderCredential2：：GetUserSid

检索与此凭据关联的用户的 SID (安全标识符) 。

备注

此类是创建 V2 凭据提供程序所必需的。 V2 凭据提供程序为用户提供个性化的登录体验。 凭据提供程序会告知登录 UI 哪些登录选项可供用户使用， 建议新的凭据提供程序应为 V2 凭据提供程序。

若要创建 ICredentialProviderCredential2 实例， GetUserSid 函数需要返回有效的 SID。 Valid 由返回的 SID 定义，该 SID 针对登录 UI 当前枚举的某个用户。

ICredentialProviderUserArray 对象是一个有用的工具，用于获取可用用户并确定要与之关联的用户。 此对象包含 ICredentialProviderUser 对象的列表，可以查询这些对象以获取有关将枚举的用户的信息。 例如，可以使用 GetStringValue 获取用户的 SID 或用户名，其中传入的参数分别为 PKEY_Identity_PrimarySid 或 PKEY_Identity_USerName 。 甚至可以使用 SetProviderFilter 筛选结果，以便仅显示一部分可用用户。

使用 ICredentialProviderUserArray 是可选的，但它是获取生成有效 SID 值所需的信息的便捷方法。 若要获取将由登录 UI 枚举的用户列表，请实现 ICredentialProviderSetUserArray 接口，以从 SetUserArray 获取 ICredentialProviderUserArray 对象。 登录 UI 在 GetCredentialCount 之前调用 SetUserArray，因此当凭据提供程序即将返回凭据时，ICredentialProviderUserArray 对象已准备就绪。

V2 凭据提供程序由“登录选项”链接下方显示的图标表示。 若要为凭据提供程序提供图标，请在凭据本身中定义CPFT_TILE_IMAGE CREDENTIAL_PROVIDER_FIELD_TYPE。 然后，确保CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR的 guidFieldType 设置为 CPFG_CREDENTIAL_PROVIDER_LOGO。 图标的建议大小为 72 x 72 像素。

与为凭据提供程序指定图标类似，还可以指定用于标识凭据提供程序的文本字符串。 当用户将鼠标悬停在图标上时，此字符串将显示在弹出窗口中。 为此，请在凭据本身中定义CPFT_SMALL_TEXT CREDENTIAL_PROVIDER_FIELD_TYPE。 然后，确保CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR的 guidFieldType 设置为 CPFG_CREDENTIAL_PROVIDER_LABEL。 此字符串应补充上述凭据提供程序图标，并具有足够的描述性，以便用户了解它是什么。 例如，图片密码提供程序的说明是“图片密码”。

何时实现

实现此接口以将凭据磁贴与登录 UI 中的特定用户磁贴相关联。

要求

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

另请参阅

Windows 10 中的凭据提供程序

ICredentialProviderCredential

ICredentialProviderCredentialEvents2