CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR structure (credentialprovider.h)

Article
08/22/2023

Décrit un champ unique dans des informations d’identification. Par exemple, une chaîne ou une image utilisateur.

Syntaxe

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

Membres

dwFieldID

Type : DWORD

ID unique du champ. Les champs doivent avoir un identificateur unique par rapport à tous les autres champs d’un fournisseur d’informations d’identification donné. Cela est vrai que les champs soient affichés ou masqués.

cpft

Type : CREDENTIAL_PROVIDER_FIELD_TYPE

Type de champ.

pszLabel

Type : LPWSTR

Pointeur vers une mémoire tampon contenant le nom convivial du champ sous la forme d’une chaîne Unicode terminée par null. Il est utilisé à des fins d’accessibilité et de mise en file d’attente. Par exemple, certains champs standard ont des noms d’amis « Nom d’utilisateur », « Mot de passe » et « Connexion à ».

guidFieldType

Type : GUID

GUID qui identifie de manière unique un type de champ. Ce membre vous permet d’encapsuler les fonctionnalités fournies par les fournisseurs d’informations d’identification existants dans leurs propres fournisseurs. Il n’est pas recommandé d’encapsuler les fournisseurs d’informations d’identification, car cela peut entraîner un comportement inattendu qui désactive les fournisseurs d’informations d’identification dans l’emballage.

Le tableau suivant répertorie les valeurs guidFieldType prises en charge par Windows. Celles-ci sont définies dans Shlguid.h.

Valeur	Signification
CPFG_LOGON_USERNAME da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b	Nom d’utilisateur entré dans une zone de texte.
CPFG_LOGON_PASSWORD 60624cfa-a477-47b1-8a8e-3a4a19981827	Mot de passe entré dans une zone de texte.
CPFG_SMARTCARD_USERNAME 3e1ecf69-568c-4d96-9d59-46444174e2d6	Nom d’utilisateur obtenu à partir d’un carte intelligent inséré.
CPFG_SMARTCARD_PIN 4fe5263b-9181-46c1-b0a4-9dedd4db7dea	Code confidentiel obtenu à partir d’un carte intelligent inséré.
CPFG_CREDENTIAL_PROVIDER_LOGO 2d837775-f6cd-464e-a745-482fd0b47493	Introduit dans Windows 8 : image utilisée pour représenter un fournisseur d’informations d’identification sur la page d’ouverture de session.
CPFG_CREDENTIAL_PROVIDER_LABEL 286BBFF3-BAD4-438F-B007-79B7267C3D48	Introduit dans Windows 8 : étiquette associée à un fournisseur d’informations d’identification sur la page d’ouverture de session.

Remarques

Chaque élément d’interface utilisateur présenté à l’utilisateur sur une vignette est défini par le fournisseur d’informations d’identification en tant que champ. Le CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR est la façon dont le fournisseur d’informations d’identification identifie les champs. Une fois qu’un champ a été défini pour un scénario d’utilisation particulier, il ne peut pas être ajouté ou soustrait. Les fournisseurs d’informations d’identification doivent définir entièrement tous leurs champs avant d’énumérer les vignettes. Si des champs doivent apparaître ou disparaître dans le cadre du processus d’acquisition des informations d’identification, ces champs ne doivent toujours pas être définis à l’avance. Utilisez CREDENTIAL_PROVIDER_FIELD_STATE pour masquer ou afficher les champs si nécessaire.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	credentialprovider.h