CREDENTIAL_PROVIDER_FIELD_DESCRIPTOR Struktur (credentialprovider.h)

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;

Elemente

dwFieldID

Typ: DWORD-

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

cpft

Typ: CREDENTIAL_PROVIDER_FIELD_TYPE

Der Feldtyp.

pszLabel

Typ: LPWSTR

Ein Zeiger auf einen Puffer, der den Anzeigenamen des Felds als Unicode-Zeichenfolge - nullbeendet enthält. Dies wird für Barrierefreiheits- und Warteschlangenzwecke verwendet. Einige Standardfelder verfügen beispielsweise über Anzeigenamen "Benutzername", "Kennwort" und "Anmelden bei".

guidFieldType

Typ: GUID

Eine GUID, die einen Feldtyp eindeutig identifiziert. Mit diesem Mitglied 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 es zu unerwartetem Verhalten führen kann, das die Anbieter von Anmeldeinformationen deaktiviert.

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

Bemerkungen

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 Verwendungsszenario definiert wurde, kann es nicht hinzugefügt oder subtrahiert werden. Anmeldeinformationsanbieter müssen alle felder vollständig definieren, bevor Kacheln aufgezählt werden. Wenn Felder im Rahmen des Anmeldeinformationserwerbsprozesses angezeigt oder ausgeblendet werden, müssen diese Felder noch vor der Zeit definiert werden. Verwenden Sie CREDENTIAL_PROVIDER_FIELD_STATE , um die Felder nach Bedarf auszublenden oder anzuzeigen.

Anforderungen