CredGetTargetInfoA-Funktion (wincred.h)
Die CredGetTargetInfo Funktion ruft alle bekannten Zielnameninformationen für den benannten Zielcomputer ab. Dies wird lokal ausgeführt und benötigt keine bestimmten Berechtigungen. Die zurückgegebenen Informationen werden voraussichtlich an die CredReadDomainCredentials und CredWriteDomainCredentials-Funktionen übergeben. Die Informationen sollten nicht für andere Zwecke verwendet werden.
Authentifizierungspakete berechnen TargetInfo- beim Versuch, sich bei einem TargetName-zu authentifizieren. Die Authentifizierungspakete speichern diese Zielinformationen zwischen, um sie für CredGetTargetInfoverfügbar zu machen. Daher stehen die Zielinformationen nur bei einem letzten Versuch zur Authentifizierung eines TargetName-zur Verfügung.
Authentifizierungspakete, die sich nicht im LSA-Prozess befinden, können eine TargetInfo- für einen späteren Abruf zwischenspeichern, indem CredGetTargetInfo- durch Aufrufen von CredReadDomainCredentials- mit dem CRED_CACHE_TARGET_INFORMATION-Flag aufgerufen wird.
Syntax
BOOL CredGetTargetInfoA(
[in] LPCSTR TargetName,
[in] DWORD Flags,
[out] PCREDENTIAL_TARGET_INFORMATIONA *TargetInfo
);
Parameter
[in] TargetName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des Zielcomputers enthält, für den Informationen abgerufen werden sollen.
[in] Flags
Flags, die den Vorgang der Funktion steuern. Das folgende Kennzeichen kann verwendet werden:
CRED_ALLOW_NAME_RESOLUTION
Wenn keine Zielinformationen für TargetName Namensauflösung gefunden werden können, erfolgt TargetName-, um sie in andere Formulare zu konvertieren. Wenn Zielinformationen für eines dieser anderen Formulare vorhanden sind, wird sie zurückgegeben. Derzeit erfolgt nur die DNS-Namensauflösung.
Dies ist nützlich, wenn die Anwendung kein Authentifizierungspaket direkt aufruft. Die Anwendung kann die TargetName- an eine andere Softwareebene übergeben, um sich beim Server zu authentifizieren, und diese Softwareebene kann den Namen auflösen und den aufgelösten Namen an das Authentifizierungspaket übergeben. Daher gibt es keine Zielinformationen für die ursprüngliche TargetName-.
[out] TargetInfo
Zeigen Sie auf einen einzelnen zugeordneten Blockpuffer, um die Zielinformationen zu enthalten. Mindestens eines der zurückgegebenen Member von TargetInfo- ist nicht NULL. Alle im Puffer enthaltenen Zeiger sind Zeiger auf Positionen innerhalb dieses einzelnen zugeordneten Blocks. Der einzelne zurückgegebene Puffer muss durch Aufrufen von CredFreefreigegeben werden.
Rückgabewert
Die Funktion gibt TRUE bei Erfolg zurück und FALSE- bei Fehlern. Die GetLastError--Funktion kann aufgerufen werden, um einen spezifischeren Statuscode abzurufen. Der folgende Statuscode kann zurückgegeben werden:
- ERROR_NOT_FOUND
Zielinformationen für den benannten Server sind nicht verfügbar.
Bemerkungen
Anmerkung
Der wincred.h-Header definiert CredGetTargetInfo als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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] |
| Zielplattform- | Fenster |
| Header- | wincred.h |
| Library | Advapi32.lib |
| DLL- | Advapi32.dll |