Поделиться через

структура CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR (credentialprovider.h)

  • Статья

Описывает одно поле в учетных данных. Например, строка или изображение пользователя.

Синтаксис

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

Члены

dwFieldID

Тип: DWORD

Уникальный идентификатор поля. Поля должны иметь уникальный идентификатор по сравнению со всеми другими полями в заданном поставщике учетных данных. Это верно независимо от того, отображаются ли поля или скрыты.

cpft

Тип: CREDENTIAL_PROVIDER_FIELD_TYPE

Тип поля.

pszLabel

Тип: LPWSTR

Указатель на буфер, содержащий понятное имя поля в виде строки Юникода, завершаемой null. Используется для специальных возможностей и очередей. Например, некоторые стандартные поля будут иметь дружественные имена "Имя пользователя", "Пароль" и "Вход".

guidFieldType

Тип: GUID

Идентификатор GUID, однозначно определяющий тип поля. Этот член позволяет переносить функции, предоставляемые существующими поставщиками учетных данных в их собственных поставщиках. Перенос поставщиков учетных данных не рекомендуется, так как это может привести к непредвиденному поведению, которое отключает встроенные поставщики учетных данных.

В следующей таблице перечислены значения guidFieldType , поддерживаемые Windows. Они определены в файле Shlguid.h.

Значение Значение
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
 ПИН-код, полученный из вставленного смарт-карта.
CPFG_CREDENTIAL_PROVIDER_LOGO
2d837775-f6cd-464e-a745-482fd0b47493
 Представлено в Windows 8: образ, используемый для представления поставщика учетных данных на странице входа.
CPFG_CREDENTIAL_PROVIDER_LABEL
286BBFF3-BAD4-438F-B007-79B7267C3D48
 Представлено в Windows 8: метка, связанная с поставщиком учетных данных на странице входа.

Комментарии

Каждый элемент пользовательского интерфейса, представленный пользователю на плитке, определяется поставщиком учетных данных как поле. В CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR поставщик учетных данных определяет поля. После определения поля для определенного сценария использования его нельзя добавить к или вычесть из него. Поставщики учетных данных должны полностью определить все свои поля перед перечислением плиток. Если поля будут отображаться или исчезать в процессе получения учетных данных, эти поля по-прежнему не должны быть определены заранее. Используйте CREDENTIAL_PROVIDER_FIELD_STATE , чтобы скрыть или отобразить поля при необходимости.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть credentialprovider.h