CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR struttura (credentialprovider.h)

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