CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR structure (credentialprovider.h)

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. Fields should have a unique identifier compared to all other fields on a given credential provider. This is true regardless of whether the fields are displayed or hidden.

cpft

Type: CREDENTIAL_PROVIDER_FIELD_TYPE

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 queuing purposes. For example, some standard fields would have friend names of "Username", "Password", and "Log On To".

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. Wrapping credential providers is not recommended as it can lead to unexpected behavior that disables in-box credential providers.

The following table lists the guidFieldType values supported by Windows. These are defined in Shlguid.h.

Remarks

Each UI element presented to the user on a tile is defined by the credential provider as a field. The CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR is how the credential provider identifies the fields. Once a field has been defined for a particular usage scenario, it can not be added to or subtracted from. Credential providers need to fully define all of their fields before enumerating tiles. If fields are going to appear or disappear as part of the credential acquisition process, those fields still not to be defined ahead of time. Use CREDENTIAL_PROVIDER_FIELD_STATE to hide or display the fields as necessary.

Requirements