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


структура 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;

Members

dwFieldID

Тип: DWORD

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

cpft

Тип: CREDENTIAL_PROVIDER_FIELD_TYPE

Тип поля.

pszLabel

Тип: LPWSTR

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

guidFieldType

Тип: GUID

ИДЕНТИФИКАТОР GUID, однозначно определяющий тип поля. Этот член позволяет упаковывать функциональные возможности, предоставляемые существующими поставщиками учетных данных в своих собственных поставщиках. Не рекомендуется упаковать поставщики учетных данных, так как это может привести к непредвиденному поведению, которое отключает встроенные поставщики учетных данных.

В следующей таблице перечислены значения guidFieldType , поддерживаемые Windows. Они определены в 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
ПИН-код, полученный из вставленной смарт-карты.
CPFG_CREDENTIAL_PROVIDER_LOGO
2d83775-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 [только классические приложения]
Header credentialprovider.h