CredFindBestCredentialA-Funktion (wincred.h)

Artikel
11/20/2024

Die CredFindBestCredential--Funktion durchsucht die Anmeldeinformationsverwaltungs datenbank (CredMan) nach der Gruppe generischer Anmeldeinformationen, die der aktuellen Anmeldesitzung zugeordnet sind, und die am besten mit der angegebenen Zielressource übereinstimmen.

Syntax

BOOL CredFindBestCredentialA(
  [in]  LPCSTR       TargetName,
  [in]  DWORD        Type,
  [in]  DWORD        Flags,
  [out] PCREDENTIALA *Credential
);

Parameter

[in] TargetName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen der Zielressource enthält, für die Anmeldeinformationen gefunden werden sollen.

[in] Type

Der Typ der zu suchden Anmeldeinformationen. Derzeit unterstützt diese Funktion nur CRED_TYPE_GENERIC.

[in] Flags

Reserviert.

[out] Credential

Die Adresse eines Zeigers auf eine CREDENTIAL- Struktur, die den Satz von Anmeldeinformationen angibt, die diese Funktion findet.

Wenn Sie mit der Verwendung dieser Struktur fertig sind, geben Sie sie frei, indem Sie die funktion CredFree aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE-zurückgegeben.

Wenn die Funktion fehlschlägt, wird FALSE-zurückgegeben. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Anmerkung

Der wincred.h-Header definiert CredFindBestCredential 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 Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	wincred.h
Library	Advapi32.lib
DLL-	Advapi32.dll

Freigeben über