CredGetTargetInfoW-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. Es wird erwartet, dass die zurückgegebenen Informationen an die Funktionen CredReadDomainCredentials und CredWriteDomainCredentials übergeben werden. 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 CredGetTargetInfo verfügbar zu machen. Daher sind die Zielinformationen nur bei einem kürzlichen Versuch verfügbar, einen TargetName zu authentifizieren.
Authentifizierungspakete, die nicht im LSA-Prozess enthalten sind, können targetInfo für den späteren Abruf durch CredGetTargetInfo zwischenspeichern, indem Sie CredReadDomainCredentials mit dem flag CRED_CACHE_TARGET_INFORMATION aufrufen.
Syntax
BOOL CredGetTargetInfoW(
[in] LPCWSTR TargetName,
[in] DWORD Flags,
[out] PCREDENTIAL_TARGET_INFORMATIONW *TargetInfo
);
Parameter
[in] TargetName
Zeiger auf eine NULL-endende 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 Flag kann verwendet werden:
CRED_ALLOW_NAME_RESOLUTION
Wenn keine Zielinformationen für die TargetName-Namensauflösung gefunden werden, erfolgt auf TargetName , um sie in andere Formulare zu konvertieren. Wenn für eines dieser anderen Formulare Zielinformationen vorhanden sind, werden sie zurückgegeben. Derzeit wird nur die DNS-Namensauflösung durchgeführt.
Dies ist nützlich, wenn die Anwendung kein Authentifizierungspaket direkt aufruft. Die Anwendung kann targetName an eine andere Softwareebene übergeben, um sich beim Server zu authentifizieren, und diese Softwareschicht kann den Namen auflösen und den aufgelösten Namen an das Authentifizierungspaket übergeben. Daher gibt es keine Zielinformationen für den ursprünglichen TargetName.
[out] TargetInfo
Zeiger auf einen einzelnen zugeordneten Blockpuffer, der die Zielinformationen enthält. Mindestens eines der zurückgegebenen Member von TargetInfo ist nicht NULL. Alle im Puffer enthaltenen Zeiger sind Zeiger auf Speicherorte innerhalb dieses einzelnen zugeordneten Blocks. Der einzelne zurückgegebene Puffer muss durch Aufrufen von CredFree freigegeben werden.
Rückgabewert
Die Funktion gibt TRUE bei Erfolg und FALSE bei Einem Fehler zurück. Die GetLastError-Funktion kann aufgerufen werden, um einen spezifischeren status Code abzurufen. Der folgende status Code kann zurückgegeben werden:
- ERROR_NOT_FOUND
Zielinformationen für den benannten Server sind nicht verfügbar.
Hinweise
Hinweis
Der wincred.h-Header definiert CredGetTargetInfo 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] |
| Zielplattform | Windows |
| Kopfzeile | wincred.h |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |