nf-wincred-creduiconfirmcredentialsa.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:wincred.CredUIConfirmCredentialsA	CredUIConfirmCredentialsA function (wincred.h)	Is called after CredUIPromptForCredentials or CredUICmdLinePromptForCredentials, to confirm the validity of the credential harvested. (ANSI)	CredUIConfirmCredentialsA wincred/CredUIConfirmCredentialsA	security\creduiconfirmcredentials.htm	security	67262844-75f0-4f68-90f6-63f9a6d2b0a1	12/05/2018	CredUIConfirmCredentials, CredUIConfirmCredentials function [Security], CredUIConfirmCredentialsA, CredUIConfirmCredentialsW, _cred_creduiconfirmcredentials, security.creduiconfirmcredentials, wincred/CredUIConfirmCredentials, wincred/CredUIConfirmCredentialsA, wincred/CredUIConfirmCredentialsW	wincred.h		Windows	Windows XP [desktop apps only]	Windows Server 2003 [desktop apps only]				CredUIConfirmCredentialsW (Unicode) and CredUIConfirmCredentialsA (ANSI)						Credui.lib	Credui.dll		Windows			19H1	CredUIConfirmCredentialsA wincred/CredUIConfirmCredentialsA	c++	APIRef kbSyntax	DllExport	Credui.dll Ext-MS-Win-security-credui-l1-1-0.dll Ext-MS-Win-security-credui-l1-1-1.dll AnalogCredUI.dll	CredUIConfirmCredentials CredUIConfirmCredentialsA CredUIConfirmCredentialsW

CredUIConfirmCredentialsA function

-description

The CredUIConfirmCredentials function is called after CredUIPromptForCredentials or CredUICmdLinePromptForCredentials, to confirm the validity of the credential harvested. CredUIConfirmCredentials must be called if the CREDUI_FLAGS_EXPECT_CONFIRMATION flag was passed to the "prompt" function, either CredUIPromptForCredentials or CredUICmdLinePromptForCredentials, and the "prompt" function returned NO_ERROR.

After calling the "prompt" function and before calling CredUIConfirmCredentials, the caller must determine whether the credentials are actually valid by using the credentials to access the resource specified by pszTargetName. The results of that validation test are passed to CredUIConfirmCredentials in the bConfirm parameter.

-parameters

-param pszTargetName [in]

Pointer to a null-terminated string that contains the name of the target for the credentials, typically a domain or server application name. This must be the same value passed as pszTargetName to CredUIPromptForCredentials or CredUICmdLinePromptForCredentials

-param bConfirm [in]

Specifies whether the credentials returned from the prompt function are valid. If TRUE, the credentials are stored in the credential manager as defined by CredUIPromptForCredentials or CredUICmdLinePromptForCredentials. If FALSE, the credentials are not stored and various pieces of memory are cleaned up.

-returns

Status of the operation is returned. The caller can check this status to determine whether the credential confirm operation succeeded. Most applications ignore this status code because the application's connection to the resource has already been done. The operation can fail because the credential was not found on the list of credentials awaiting confirmation, or because the attempt to write or delete the credential failed. Failure to find the credential on the list can occur because the credential was never queued or as a result of too many credentials being queued. Up to five credentials can be queued before older ones are discarded as newer ones are queued.

Return code	Description
NO_ERROR - (zero)	Confirm operation succeeded.
ERROR_NOT_FOUND	The subject credential could not be found on the confirmation waiting list.
ERROR_INVALID_PARAMETER	An attempt to confirm a waiting credential failed because the credential contained data that was not valid or was inconsistent.

-remarks

Note

The wincred.h header defines CredUIConfirmCredentials as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.