CredFindBestCredentialA-Funktion (wincred.h)

Artikel
08/27/2023

Die CredFindBestCredential-Funktion durchsucht die CredMan-Datenbank ( Credentials Management ) nach den generischen Anmeldeinformationen, die der aktuellen Anmeldesitzung zugeordnet sind und der angegebenen Zielressource am besten entsprechen.

Syntax

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

Parameter

[in] TargetName

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

[in] Type

Der Typ der zu suchenden 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 die Verwendung dieser Struktur abgeschlossen haben, geben Sie sie frei, indem Sie die CredFree-Funktion aufrufen.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück.

Wenn die Funktion fehlschlägt, gibt sie FALSE zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Hinweis

Der wincred.h-Header definiert CredFindBestCredential 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 Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wincred.h
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Freigeben über