CredUIConfirmCredentialsA-Funktion (wincred.h)

Artikel
08/27/2023

Die CredUIConfirmCredentials-Funktion wird nach CredUIPromptForCredentials oder CredUICmdLinePromptForCredentials aufgerufen, um die Gültigkeit der abgerufenen 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 funktion "prompt" wurde NO_ERROR zurückgegeben.

Nach dem Aufrufen der Funktion "prompt" und vor dem Aufruf von CredUIConfirmCredentials muss der Aufrufer ermitteln, ob die Anmeldeinformationen tatsächlich gültig sind, indem er die Anmeldeinformationen verwendet, um auf die durch pszTargetName angegebene Ressource zuzugreifen. Die Ergebnisse dieses Validierungstests werden im bConfirm-Parameter an CredUIConfirmCredentials übergeben.

Syntax

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

Parameter

[in] pszTargetName

Zeiger auf eine NULL-endende 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 als pszTargetName an CredUIPromptForCredentials oder CredUICmdLinePromptForCredentials übergeben wird.

[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 durch CredUIPromptForCredentials oder CredUICmdLinePromptForCredentials definiert. Bei FALSE werden die Anmeldeinformationen nicht gespeichert, und verschiedene Speicherelemente werden bereinigt.

Rückgabewert

Der Status des Vorgangs wird zurückgegeben. Der Aufrufer kann diese status überprüfen, um festzustellen, ob der Vorgang zur Bestätigung der Anmeldeinformationen erfolgreich war. Die meisten Anwendungen ignorieren diesen status Code, da die Verbindung der Anwendung mit der Ressource bereits hergestellt wurde. Der Vorgang kann fehlschlagen, weil die Anmeldeinformationen nicht in der Liste der Anmeldeinformationen gefunden wurden, die auf die Bestätigung warten, oder weil beim Versuch, die Anmeldeinformationen zu schreiben oder zu löschen, ein Fehler aufgetreten ist. Fehler beim Finden der Anmeldeinformationen in der Liste kann auftreten, weil die Anmeldeinformationen nie in die Warteschlange eingereiht wurden oder weil zu viele Anmeldeinformationen in die Warteschlange eingereiht wurden. Bis zu fünf Anmeldeinformationen können in die Warteschlange gestellt werden, bevor ältere Anmeldeinformationen verworfen werden, während neuere anmeldet werden.

Rückgabecode	Beschreibung
NO_ERROR – (null)	Bestätigen Sie, dass der Vorgang erfolgreich war.
ERROR_NOT_FOUND	Die Anmeldeinformationen des Antragstellers konnten nicht in der Bestätigungswarteliste gefunden werden.
ERROR_INVALID_PARAMETER	Ein Versuch, eine wartenden Anmeldeinformationen zu bestätigen, ist fehlgeschlagen, da die Anmeldeinformationen ungültige oder inkonsistente Daten enthielten.

Hinweise

Hinweis

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

Freigeben über