CredUIConfirmCredentialsA-Funktion (wincred.h)

Artikel
11/20/2024

Die funktion CredUIConfirmCredentials wird nach CredUIPromptForCredentials oder CredUICmdLinePromptForCredentialsaufgerufen, um die Gültigkeit der gesammelten Anmeldeinformationen zu bestätigen. CredUIConfirmCredentials muss aufgerufen werden, wenn das CREDUI_FLAGS_EXPECT_CONFIRMATION Flag an die Funktion "prompt" übergeben wurde, entweder CredUIPromptForCredentials oder CredUICmdLinePromptForCredentials, und die "prompt"-Funktion, die NO_ERROR zurückgegeben wurde.

Nach dem Aufrufen der Funktion "prompt" und vor dem Aufrufen CredUIConfirmCredentialsmuss der Aufrufer bestimmen, ob die Anmeldeinformationen tatsächlich gültig sind, indem die Anmeldeinformationen verwendet werden, um auf die durch pszTargetNameangegebene Ressource zuzugreifen. Die Ergebnisse dieses Überprüfungstests werden an CredUIConfirmCredentials im bConfirm-Parameter übergeben.

Syntax

CREDUIAPI DWORD CredUIConfirmCredentialsA(
  [in] PCSTR pszTargetName,
  [in] BOOL  bConfirm
);

Parameter

[in] pszTargetName

Zeigen Sie auf eine NULL--terminated-Zeichenfolge, die den Namen des Ziels für die Anmeldeinformationen enthält, in der Regel ein Domänen- oder Serveranwendungsname. Dies muss derselbe Wert sein, der wie pszTargetName an CredUIPromptForCredentials oder CredUICmdLinePromptForCredentials

[in] bConfirm

Gibt an, ob die von der Eingabeaufforderungsfunktion zurückgegebenen Anmeldeinformationen gültig sind. Wenn TRUE-, werden die Anmeldeinformationen im Anmeldeinformations-Manager gespeichert, wie von CredUIPromptForCredentials oder CredUICmdLinePromptForCredentialsdefiniert. Wenn FALSE-, werden die Anmeldeinformationen nicht gespeichert, und verschiedene Speicherelemente werden bereinigt.

Rückgabewert

Der Status des Vorgangs wird zurückgegeben. Der Aufrufer kann diesen Status überprüfen, um festzustellen, ob der Vorgang für die Bestätigung der Anmeldeinformationen erfolgreich war. Die meisten Anwendungen ignorieren diesen Statuscode, da die Verbindung der Anwendung mit der Ressource bereits hergestellt wurde. Der Vorgang kann fehlschlagen, da die Anmeldeinformationen nicht in der Liste der Anmeldeinformationen gefunden wurden, die auf die Bestätigung warten, oder weil der Versuch, die Anmeldeinformationen zu schreiben oder zu löschen, fehlgeschlagen ist. Fehler beim Auffinden der Anmeldeinformationen in der Liste, da die Anmeldeinformationen nie in die Warteschlange gestellt wurden oder aufgrund zu vieler Anmeldeinformationen in die Warteschlange gestellt wurden. Bis zu fünf Anmeldeinformationen können in die Warteschlange gestellt werden, bevor ältere verworfen werden, wenn neuere in die Warteschlange gestellt werden.

Rückgabecode	Beschreibung
NO_ERROR - (Null)	Der Vorgang wurde erfolgreich bestätigt.
ERROR_NOT_FOUND	Die Anmeldeinformationen des Betreffs wurden in der Bestätigungswarteliste nicht gefunden.
ERROR_INVALID_PARAMETER	Fehler beim Versuch, eine wartende Anmeldeinformation zu bestätigen, da die Anmeldeinformationen daten enthielten, die ungültig waren oder inkonsistent waren.

Bemerkungen

Anmerkung

Der wincred.h-Header definiert CredUIConfirmCredentials 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

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	Credui.lib
DLL-	Credui.dll

Freigeben über