CREDENTIAL_TARGET_INFORMATIONA Struktur (wincred.h)
Die CREDENTIAL_TARGET_INFORMATION-Struktur enthält den Namen, die Domäne und die Struktur des Zielcomputers.
Syntax
typedef struct _CREDENTIAL_TARGET_INFORMATIONA {
LPSTR TargetName;
LPSTR NetbiosServerName;
LPSTR DnsServerName;
LPSTR NetbiosDomainName;
LPSTR DnsDomainName;
LPSTR DnsTreeName;
LPSTR PackageName;
ULONG Flags;
DWORD CredTypeCount;
LPDWORD CredTypes;
} CREDENTIAL_TARGET_INFORMATIONA, *PCREDENTIAL_TARGET_INFORMATIONA;
Angehörige
TargetName
Der Name des Zielservers, wie vom Aufrufer angegeben, der auf das Ziel zugreift. Es ist in der Regel der NetBIOS- oder DNS-Name des Zielservers.
NetbiosServerName
NetBIOS-Name des Zielservers. Wenn der Name nicht bekannt ist, kann dieses Element NULL-sein.
DnsServerName
DNS-Name des Zielservers. Wenn der Name nicht bekannt ist, kann dieses Element NULL-sein.
NetbiosDomainName
NetBIOS-Name der Domäne des Zielservers. Wenn der Name nicht bekannt ist, kann dieses Element NULL-sein. Wenn der Zielserver Mitglied einer Arbeitsgruppe ist, muss dieses Mitglied NULL-sein.
DnsDomainName
DNS-Name der Domäne des Zielservers. Wenn der Name nicht bekannt ist, kann dieses Element NULL-sein. Wenn der Zielserver Mitglied einer Arbeitsgruppe ist, muss dieses Mitglied NULL-sein.
DnsTreeName
DNS-Name der Struktur des Zielservers. Wenn der Strukturname nicht bekannt ist, kann dieses Element NULL-sein. Wenn der Zielserver Mitglied einer Arbeitsgruppe ist, muss dieses Mitglied NULL-sein.
PackageName
Name des Authentifizierungspakets, das die Werte NetbiosServerName, DnsServerName, NetbiosDomainName, DnsDomainNameund DnsTreeName als Funktion von TargetNamebestimmt. Dieses Mitglied kann als Paketname an AcquireCredentialsHandle übergeben werden.
Flags
Attribute des Ziels.
- CRED_TI_SERVER_FORMAT_UNKNOWN
(1) — Legen Sie fest, ob das Authentifizierungspaket nicht bestimmen kann, ob der Servername ein DNS-Name oder ein NetBIOS-Name ist. In diesem Fall wird der NetbiosServerName Member auf NULL- festgelegt, und das DnsServerName Member wird auf den Servernamen des unbekannten Formats festgelegt.
- CRED_TI_DOMAIN_FORMAT_UNKNOWN
(2) — Legen Sie fest, ob das Authentifizierungspaket nicht bestimmen kann, ob es sich bei dem Domänennamen um einen DNS-Namen oder einen NetBIOS-Namen handelt. In diesem Fall wird der NetbiosDomainName Member auf NULL- festgelegt, und das DnsDomainName Member wird auf den Domänennamen des unbekannten Formats festgelegt.
- CRED_TI_ONLY_PASSWORD_REQUIRED
(4) — Legen Sie fest, ob das Authentifizierungspaket festgestellt hat, dass der Server nur ein Kennwort für die Authentifizierung benötigt. Der Anrufer kann dieses Flag verwenden, um nur zur Eingabe eines Kennworts und nicht zu einem Benutzernamen aufzufordern.
Für gespeicherte Anmeldeinformationen ist ein UserName-Mitglied erforderlich. Der Wert <DnsServerName>\Guest oder <NetbiosServerName>\Guest sollte für diese Server verwendet werden.
CredTypeCount
Anzahl der Elemente im CredTypes Array.
CredTypes
Array, das die für das vom Zielserver verwendeten Authentifizierungspaket zulässigen Anmeldeinformationstypen angibt. Jedes Element ist einer der definierten CRED_TYPE_*. Die Reihenfolge dieses Arrays gibt die Präferenzreihenfolge des Authentifizierungspakets an. Weitere bevorzugte Typen werden weiter oben in der Liste angegeben.
Bemerkungen
Anmerkung
Der wincred.h-Header definiert CREDENTIAL_TARGET_INFORMATION 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
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
Header- | wincred.h |