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 besonderen Berechtigungen. Die zurückgegebenen Informationen werden voraussichtlich an die Funktionen CredReadDomainCredentials und CredWriteDomainCredentials übergeben. Die Informationen sollten nicht für andere Zwecke verwendet werden.

Authentifizierungspakete berechnen TargetInfo beim Versuch, sich bei 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 letzten Versuch verfügbar, einen TargetName zu authentifizieren.

Authentifizierungspakete, die sich nicht im LSA-Prozess befinden, können targetInfo für den späteren Abruf durch CredGetTargetInfo zwischenspeichern, indem Sie CredReadDomainCredentials mit dem CRED_CACHE_TARGET_INFORMATION-Flag aufrufen.

Syntax

BOOL CredGetTargetInfoA(
  [in]  LPCSTR                          TargetName,
  [in]  DWORD                           Flags,
  [out] PCREDENTIAL_TARGET_INFORMATIONA *TargetInfo
);

Parameter

[in] TargetName

Zeiger auf eine NULL-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 können, wird auf TargetName ausgeführt, um sie in andere Formulare zu konvertieren. Wenn Zielinformationen für eines dieser anderen Formulare vorhanden sind, werden sie zurückgegeben. Derzeit wird nur die DNS-Namensauflösung durchgeführt.

Dies ist nützlich, wenn die Anwendung ein Authentifizierungspaket nicht 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 Positionen 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 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 nicht codierungsneutralem Code 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
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

Weitere Informationen

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

GetLastError