Export (0) Print
Expand All
Expand Minimize

CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR structure

Describes a single field in a credential. For example, a string or a user image.

Syntax


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

Members

dwFieldID

Type: DWORD

The unique ID of the field.

cpft

Type: CREDENTIAL_PROVIDER_FIELD_TYPE

A value from the CREDENTIAL_PROVIDER_FIELD_TYPE enumeration that specifies the field type.

pszLabel

Type: LPWSTR

A pointer to a buffer containing the friendly name of the field as a null-terminated Unicode string. This is used for accessibility and cueing purposes.

guidFieldType

Type: GUID

A GUID that uniquely identifies a type of field. This member enables you to wrap functionality provided by existing credential providers in their own providers. For example, the password provider username, password, smart card provider username, and Personal Identification Number (PIN) field each have a GUID that could be passed in this value using one of the following items defined in Shlguid.h

ValueMeaning
CPFG_LOGON_USERNAME
da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b

The user name entered into a text box.

CPFG_LOGON_PASSWORD
60624cfa-a477-47b1-8a8e-3a4a19981827

The password entered into a text box.

CPFG_SMARTCARD_USERNAME
3e1ecf69-568c-4d96-9d59-46444174e2d6

The user name obtained from an inserted smart card.

CPFG_SMARTCARD_PIN
4fe5263b-9181-46c1-b0a4-9dedd4db7dea

The PIN obtained from an inserted smart card.

CPFG_CREDENTIAL_PROVIDER_LOGO
2d837775-f6cd-464e-a745-482fd0b47493

Introduced in Windows 8: The image used to represent a credential provider on the logon page.

CPFG_CREDENTIAL_PROVIDER_LABEL
286BBFF3-BAD4-438F-B007-79B7267C3D48

Introduced in Windows 8: The label associated with a credential provider on the logon page.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Credentialprovider.h

IDL

Credentialprovider.idl

 

 

Community Additions

ADD
Show:
© 2014 Microsoft