CredUIConfirmCredentialsA-Funktion (wincred.h)

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.

Hinweise

Anforderungen