CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR-Struktur (credentialprovider.h)

Artikel
08/22/2023

Beschreibt ein einzelnes Feld in einer Anmeldeinformation. Beispiel: eine Zeichenfolge oder ein Benutzerbild.

Syntax

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

Member

dwFieldID

Art: DWORD

Die eindeutige ID des Felds. Felder sollten im Vergleich zu allen anderen Feldern eines bestimmten Anmeldeinformationsanbieters über einen eindeutigen Bezeichner verfügen. Dies gilt unabhängig davon, ob die Felder angezeigt oder ausgeblendet werden.

cpft

Typ: CREDENTIAL_PROVIDER_FIELD_TYPE

Der Typ des Felds.

pszLabel

Typ: LPWSTR

Ein Zeiger auf einen Puffer, der den Anzeigenamen des Felds als unicode-Zeichenfolge mit Null-Endung enthält. Dies wird für Barrierefreiheits- und Warteschlangenzwecke verwendet. Einige Standardfelder weisen beispielsweise die Namen "Benutzername", "Kennwort" und "Anmelden bei" auf.

guidFieldType

Typ: GUID

Eine GUID, die einen Feldtyp eindeutig identifiziert. Mit diesem Member können Sie Funktionen umschließen, die von vorhandenen Anmeldeinformationsanbietern in ihren eigenen Anbietern bereitgestellt werden. Das Umschließen von Anmeldeinformationsanbietern wird nicht empfohlen, da dies zu unerwartetem Verhalten führen kann, das die Anbieter von im Lieferumfang enthaltenen Anmeldeinformationen deaktiviert.

In der folgenden Tabelle sind die guidFieldType-Werte aufgeführt, die von Windows unterstützt werden. Diese werden in Shlguid.h definiert.

Wert	Bedeutung
CPFG_LOGON_USERNAME da15bbe8-954sd-4fd3-b0f4-1fb5b90b174b	Der in ein Textfeld eingegebene Benutzername.
CPFG_LOGON_PASSWORD 60624cfa-a477-47b1-8a8e-3a4a19981827	Das in ein Textfeld eingegebene Kennwort.
CPFG_SMARTCARD_USERNAME 3e1ecf69-568c-4d96-9d59-46444174e2d6	Der Benutzername, der von einem eingefügten smarten Karte abgerufen wurde.
CPFG_SMARTCARD_PIN 4fe5263b-9181-46c1-b0a4-9dedd4db7dea	Die PIN, die von einem eingefügten smarten Karte erhalten wurde.
CPFG_CREDENTIAL_PROVIDER_LOGO 2d837775-f6cd-464e-a745-482fd0b47493	Eingeführt in Windows 8: Das Image, das verwendet wird, um einen Anmeldeinformationsanbieter auf der Anmeldeseite darzustellen.
CPFG_CREDENTIAL_PROVIDER_LABEL 286BBFF3-BAD4-438F-B007-79B7267C3D48	Einführung in Windows 8: Die Bezeichnung, die einem Anmeldeinformationsanbieter auf der Anmeldeseite zugeordnet ist.

Hinweise

Jedes Benutzeroberflächenelement, das dem Benutzer auf einer Kachel angezeigt wird, wird vom Anmeldeinformationsanbieter als Feld definiert. Die CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR ist, wie der Anmeldeinformationsanbieter die Felder identifiziert. Nachdem ein Feld für ein bestimmtes Nutzungsszenario definiert wurde, kann es nicht hinzugefügt oder subtrahiert werden. Anmeldeinformationsanbieter müssen alle felder vollständig definieren, bevor sie Kacheln auflisten. Wenn Felder im Rahmen des Anmeldeinformationserfassungsprozesses angezeigt oder ausgeblendet werden, müssen diese Felder immer noch nicht im Voraus definiert werden. Verwenden Sie CREDENTIAL_PROVIDER_FIELD_STATE , um die Felder nach Bedarf auszublenden oder anzuzeigen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	credentialprovider.h

Share via