CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR struttura (credentialprovider.h)

Articolo
08/22/2023

Descrive un singolo campo in una credenziale. Ad esempio, una stringa o un'immagine utente.

Sintassi

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

Members

dwFieldID

Tipo: DWORD

ID univoco del campo. I campi devono avere un identificatore univoco rispetto a tutti gli altri campi in un determinato provider di credenziali. Ciò è vero indipendentemente dal fatto che i campi vengano visualizzati o nascosti.

cpft

Tipo: CREDENTIAL_PROVIDER_FIELD_TYPE

Tipo del campo.

pszLabel

Tipo: LPWSTR

Puntatore a un buffer contenente il nome descrittivo del campo come stringa Unicode con terminazione null. Questa operazione viene usata per scopi di accessibilità e accodamento. Ad esempio, alcuni campi standard avrebbero nomi amici di "Username", "Password" e "Accedi a".

guidFieldType

Tipo: GUID

GUID che identifica in modo univoco un tipo di campo. Questo membro consente di eseguire il wrapping delle funzionalità fornite dai provider di credenziali esistenti nei propri provider. Il wrapping dei provider di credenziali non è consigliato perché può causare un comportamento imprevisto che disabilita i provider di credenziali in-box.

Nella tabella seguente sono elencati i valori guidFieldType supportati da Windows. Questi sono definiti in Shlguid.h.

Valore	Significato
CPFG_LOGON_USERNAME da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b	Nome utente immesso in una casella di testo.
CPFG_LOGON_PASSWORD 60624cfa-a477-47b1-8a8e-3a4a19981827	Password immessa in una casella di testo.
CPFG_SMARTCARD_USERNAME 3e1ecf69-568c-4d96-9d59-46444174e2d6	Nome utente ottenuto da una smart card inserita.
CPFG_SMARTCARD_PIN 4fe5263b-9181-46c1-b0a4-9dedd4db7dea	PIN ottenuto da una smart card inserita.
CPFG_CREDENTIAL_PROVIDER_LOGO 2d837775-f6cd-464e-a745-482fd0b47493	Introdotta in Windows 8: l'immagine usata per rappresentare un provider di credenziali nella pagina di accesso.
CPFG_CREDENTIAL_PROVIDER_LABEL 286BBFF3-BAD4-438F-B007-79B7267C3D48	Introdotta in Windows 8: etichetta associata a un provider di credenziali nella pagina di accesso.

Commenti

Ogni elemento dell'interfaccia utente presentato all'utente in un riquadro è definito dal provider di credenziali come campo. Il CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR è il modo in cui il provider di credenziali identifica i campi. Una volta definito un campo per uno scenario di utilizzo specifico, non può essere aggiunto o sottratto da. I provider di credenziali devono definire completamente tutti i campi prima di enumerare i riquadri. Se i campi verranno visualizzati o spariti come parte del processo di acquisizione delle credenziali, tali campi non verranno ancora definiti in anticipo. Usare CREDENTIAL_PROVIDER_FIELD_STATE per nascondere o visualizzare i campi in base alle esigenze.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	credentialprovider.h