CREDENTIALW-Struktur (wincred.h)

Die CREDENTIAL--Struktur enthält eine einzelne Anmeldeinformation.

Syntax

typedef struct _CREDENTIALW {
  DWORD                  Flags;
  DWORD                  Type;
#if ...
  wchar_t                *TargetName;
#else
  LPWSTR                 TargetName;
#endif
#if ...
  wchar_t                *Comment;
#else
  LPWSTR                 Comment;
#endif
  FILETIME               LastWritten;
  DWORD                  CredentialBlobSize;
  LPBYTE                 CredentialBlob;
  DWORD                  Persist;
  DWORD                  AttributeCount;
  PCREDENTIAL_ATTRIBUTEW Attributes;
#if ...
  wchar_t                *TargetAlias;
#else
  LPWSTR                 TargetAlias;
#endif
#if ...
  wchar_t                *UserName;
#else
  LPWSTR                 UserName;
#endif
} CREDENTIALW, *PCREDENTIALW;

Angehörige

Flags

Ein Bitelement, das Merkmale der Anmeldeinformationen identifiziert. Nicht definierte Bits sollten als Null initialisiert und andernfalls nicht geändert werden, um zukünftige Verbesserungen zu ermöglichen.

Type

Der Typ der Anmeldeinformationen. Dieses Element kann nicht geändert werden, nachdem die Anmeldeinformationen erstellt wurden. Die folgenden Werte sind gültig.

TargetName

Der Name der Anmeldeinformationen. Die TargetName- und Typ Member identifizieren die Anmeldeinformationen eindeutig. Dieses Element kann nicht geändert werden, nachdem die Anmeldeinformationen erstellt wurden. Stattdessen sollten die Anmeldeinformationen mit dem alten Namen gelöscht und die Anmeldeinformationen mit dem neuen Namen erstellt werden.

Wenn Typ-CRED_TYPE_DOMAIN_PASSWORD oder CRED_TYPE_DOMAIN_CERTIFICATEist, identifiziert dieses Element den Server oder server, für den die Anmeldeinformationen verwendet werden sollen. Das Element ist entweder ein NetBIOS- oder DNS-Servername, ein DNS-Hostnamensuffix, das ein Platzhalterzeichen, einen NetBIOS- oder DNS-Domänennamen enthält, der eine Platzhalterzeichensequenz oder ein Sternchen enthält.

Wenn TargetName ein DNS-Hostname ist, kann das TargetAlias Mitglied der NetBIOS-Name des Hosts sein.

Wenn die TargetName ein DNS-Hostnamensuffix ist, das ein Platzhalterzeichen enthält, ist die äußerst linke Bezeichnung des DNS-Hostnamens ein Sternchen (*), das angibt, dass der Zielname ein beliebiger Server ist, dessen Name auf dem angegebenen Namen endet, z. B. *.microsoft.com.

Wenn der TargetName ein Domänenname ist, der eine Platzhalterzeichensequenz enthält, ist die Syntax der Domänenname, gefolgt von einem umgekehrten Schrägstrich und Sternchen (\*), der angibt, dass der Zielname ein beliebiger Server ist, der Mitglied der benannten Domäne (oder des Bereichs) ist.

Wenn TargetName ein DNS-Domänenname ist, der eine Platzhalterzeichensequenz enthält, kann das TargetAlias Mitglied ein NetBIOS-Domänenname sein, der eine Platzhaltersequenz für dieselbe Domäne verwendet.

Wenn TargetName- eine DFS-Freigabe angibt, z. B. DfsRoot\DfsShare, stimmt diese Anmeldeinformation mit der jeweiligen DFS-Freigabe überein, und alle Server, die über diese DFS-Freigabe erreicht wurden.

Wenn TargetName- ein einzelnes Sternchen (*) ist, entspricht diese Anmeldeinformation jedem Servernamen.

Wenn TargetName- CRED_SESSION_WILDCARD_NAME ist, entspricht diese Anmeldeinformation einem beliebigen Servernamen. Diese Anmeldeinformationen entsprechen vor einem einzelnen Sternchen und sind nur gültig, wenn PersistCRED_PERSIST_SESSIONist. Die Anmeldeinformationen können von Anwendungen festgelegt werden, die die Standardanmeldeinformationen vorübergehend außer Kraft setzen möchten.

Dieses Element darf nicht länger als CRED_MAX_DOMAIN_TARGET_NAME_LENGTH (337) Zeichen sein.

Wenn der Typ- CRED_TYPE_GENERIC ist, sollte dieser Member den Dienst identifizieren, der die Anmeldeinformationen zusätzlich zum tatsächlichen Ziel verwendet. Microsoft schlägt vor, dass der Name dem Namen des Unternehmens vorangestellt wird, das den Dienst implementiert. Microsoft verwendet das Präfix "Microsoft". Dienste, die von Microsoft geschrieben wurden, sollten ihren Dienstnamen anfügen, z. B. Microsoft_RAS_TargetName. Dieses Element darf nicht länger als CRED_MAX_GENERIC_TARGET_NAME_LENGTH (32767) Zeichen sein.

Bei diesem Element wird die Groß-/Kleinschreibung nicht beachtet.

Comment

Ein Zeichenfolgenkommentar des Benutzers, der diese Anmeldeinformationen beschreibt. Dieses Element darf nicht länger als CRED_MAX_STRING_LENGTH (256) Zeichen sein.

LastWritten

Die Zeit in koordinierter Weltzeit (Greenwich Mean Time) der letzten Änderung der Anmeldeinformationen. Bei Schreibvorgängen wird der Wert dieses Elements ignoriert.

CredentialBlobSize

Die Größe des CredentialBlob Mitglieds in Byte. Dieses Element darf nicht größer als CRED_MAX_CREDENTIAL_BLOB_SIZE (5*512)-Bytes sein.

CredentialBlob

Geheime Daten für die Anmeldeinformationen. Das CredentialBlob Mitglied kann sowohl gelesen als auch geschrieben werden.

Wenn der Type Member CRED_TYPE_DOMAIN_PASSWORDist, enthält dieses Element das Unicode-Kennwort für UserName. Die CredentialBlob- und CredentialBlobSize Member enthalten kein nachfolgendes Nullzeichen. Für CRED_TYPE_DOMAIN_PASSWORDkann dieses Mitglied nur von den Authentifizierungspaketen gelesen werden.

Wenn der Type Member CRED_TYPE_DOMAIN_CERTIFICATEist, enthält dieses Element die eindeutige Unicode-PIN für UserName. Die CredentialBlob- und CredentialBlobSize Member enthalten kein nachfolgendes Nullzeichen. Außerdem kann dieses Mitglied nur von den Authentifizierungspaketen gelesen werden.

Wenn der Type Member CRED_TYPE_GENERICist, wird dieses Element von der Anwendung definiert.

Es wird erwartet, dass Die Anmeldeinformationen portierbar sind. Anwendungen sollten sicherstellen, dass die Daten in CredentialBlob portierbar sind. Die Anwendung definiert den Byte-Endian und die Ausrichtung der Daten in CredentialBlob.

Persist

Definiert die Persistenz dieser Anmeldeinformationen. Dieses Mitglied kann gelesen und geschrieben werden.

AttributeCount

Die Anzahl der anwendungsdefinierten Attribute, die den Anmeldeinformationen zugeordnet werden sollen. Dieses Mitglied kann gelesen und geschrieben werden. Der Wert darf nicht größer als CRED_MAX_ATTRIBUTES (64) sein.

Attributes

Anwendungsdefinierte Attribute, die den Anmeldeinformationen zugeordnet sind. Dieses Mitglied kann gelesen und geschrieben werden.

TargetAlias

Alias für das element TargetName. Dieses Mitglied kann gelesen und geschrieben werden. Er darf nicht länger als CRED_MAX_STRING_LENGTH (256) Zeichen sein.

Wenn die Anmeldeinformationen TypCRED_TYPE_GENERICsind, kann dieses Element nichtNULL-sein, der Anmeldeinformations-Manager ignoriert jedoch das Element.

UserName

Der Benutzername des Kontos, das zum Herstellen einer Verbindung mit TargetName-verwendet wird.

Wenn die Anmeldeinformationen TypCRED_TYPE_DOMAIN_PASSWORDsind, kann es sich um einen DomainName\UserName oder einen UPN handeln.

Wenn die Anmeldeinformationen TypCRED_TYPE_DOMAIN_CERTIFICATEsind, muss es sich bei diesem Element um einen marshallierten Zertifikatverweis sein, der durch Aufrufen von CredMarshalCredential mit einer CertCredential erstellt wurde.

Wenn die Anmeldeinformationen TypCRED_TYPE_GENERICsind, kann dieses Element nichtNULL-sein, der Anmeldeinformations-Manager ignoriert jedoch das Element.

Dieses Element darf nicht länger als CRED_MAX_USERNAME_LENGTH (513) Zeichen sein.

Bemerkungen

Anforderungen