CREDENTIAL_ATTRIBUTEA-Struktur (wincred.h)

Die CREDENTIAL_ATTRIBUTE-Struktur enthält ein anwendungsdefiniertes Attribut der Anmeldeinformationen. Ein Attribut ist ein Schlüsselwort (keyword)-Wert-Paar. Es liegt an der Anwendung, die Bedeutung des Attributs zu definieren.

Syntax

typedef struct _CREDENTIAL_ATTRIBUTEA {
  LPSTR  Keyword;
  DWORD  Flags;
  DWORD  ValueSize;
  LPBYTE Value;
} CREDENTIAL_ATTRIBUTEA, *PCREDENTIAL_ATTRIBUTEA;

Member

Keyword

Name des anwendungsspezifischen Attributs. Namen sollten im Format <CompanyName>_<Name> vorliegen.

Dieser Member darf nicht länger als CRED_MAX_STRING_LENGTH (256) Zeichen sein.

Flags

Identifiziert Die Merkmale des Anmeldeinformationsattributs. Dieser Member ist reserviert und sollte ursprünglich als null initialisiert und nicht anderweitig geändert werden, um zukünftige Erweiterungen zu ermöglichen.

ValueSize

Länge des Werts in Bytes. Dieser Member darf nicht größer als CRED_MAX_VALUE_SIZE (256) sein.

Value

Dem Attribut zugeordnete Daten. Wenn Value eine Textzeichenfolge ist, sollte Value gemäß der Konvention nicht das nachfolgende 0-Zeichen enthalten und in UNICODE sein.

Anmeldeinformationen müssen portierbar sein. Die Anwendung sollte sicherstellen, dass die Daten im Wert portierbar sind. Es liegt in der Verantwortung der Anwendung, das Byte-Endian und die Ausrichtung der Daten in Value zu definieren.

Hinweise

Hinweis

Der wincred.h-Header definiert CREDENTIAL_ATTRIBUTE als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	wincred.h