通过

CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR结构（credentialprovider.h）

描述凭据中的单个字段。 例如，字符串或用户图像。

Syntax

typedef struct _CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR {
  DWORD                          dwFieldID;
  CREDENTIAL_PROVIDER_FIELD_TYPE cpft;
  LPWSTR                         pszLabel;
  GUID                           guidFieldType;
} CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR;

Members

dwFieldID

类型：DWORD

字段的唯一 ID。 与给定凭据提供程序上所有其他字段相比，字段应具有唯一标识符。 无论字段是显示还是隐藏，都是如此。

cpft

类型： CREDENTIAL_PROVIDER_FIELD_TYPE

字段类型。

pszLabel

类型： LPWSTR

指向缓冲区的指针，该缓冲区包含字段的友好名称作为 null-terminated Unicode 字符串。 这用于辅助功能和排队目的。 例如，某些标准字段的友好名称为“Username”、“Password”和“Log On To”。

guidFieldType

类型： GUID

唯一标识字段类型的 GUID。 此成员使你可以在其自己的提供程序中包装现有凭据提供程序提供的功能。 不建议包装凭据提供程序，因为它可能会导致意外行为禁用内置凭据提供程序。

下表列出了 Windows 支持的 guidFieldType 值。 这些定义在 Shlguid.h 中。

价值 Meaning
CPFG_LOGON_USERNAME
da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b
 在文本框中输入的用户名。
CPFG_LOGON_PASSWORD
60624cfa-a477-47b1-8a8e-3a4a19981827
 输入到文本框中的密码。
CPFG_SMARTCARD_USERNAME
3e1ecf69-568c-4d96-9d59-46444174e2d6
 从插入的智能卡获取的用户名。
CPFG_SMARTCARD_PIN
4fe5263b-9181-46c1-b0a4-9dedd4db7dea
 从插入的智能卡获取的 PIN。
CPFG_CREDENTIAL_PROVIDER_LOGO
2d837775-f6cd-464e-a745-482fd0b47493
 Windows 8 中引入：用于在登录页上表示凭据提供程序的图像。
CPFG_CREDENTIAL_PROVIDER_LABEL
286BBFF3-BAD4-438F-B007-79B7267C3D48
 在 Windows 8 中引入：与登录页上的凭据提供程序关联的标签。

注解

磁贴上向用户呈现的每个 UI 元素都由凭据提供程序定义为字段。 CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR是凭据提供程序如何标识字段。 为特定使用方案定义字段后，无法将其添加到或减去。 凭据提供程序需要在枚举磁贴之前完全定义其所有字段。 如果字段将在凭据获取过程中出现或消失，则仍需提前定义这些字段。 使用 CREDENTIAL_PROVIDER_FIELD_STATE 根据需要隐藏或显示字段。

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2008 [仅限桌面应用]
Header credentialprovider.h
  • Last updated on