Função CredUIConfirmCredentialsA (wincred.h)

A função CredUIConfirmCredentials é chamada após CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials, para confirmar a validade da credencial colhida. CredUIConfirmCredentials devem ser chamados se o sinalizador CREDUI_FLAGS_EXPECT_CONFIRMATION foi passado para a função "prompt", CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials e a função "prompt" retornada NO_ERROR.

Depois de chamar a função "prompt" e antes de chamar CredUIConfirmCredentials, o chamador deve determinar se as credenciais são realmente válidas usando as credenciais para acessar o recurso especificado por pszTargetName. Os resultados desse teste de validação são passados para CredUIConfirmCredentials no parâmetro bConfirm .

Sintaxe

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

Parâmetros

[in] pszTargetName

Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do destino para as credenciais, normalmente um nome de aplicativo de domínio ou servidor. Esse deve ser o mesmo valor passado como pszTargetName para CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials

[in] bConfirm

Especifica se as credenciais retornadas da função prompt são válidas. Se TRUE, as credenciais serão armazenadas no gerenciador de credenciais, conforme definido por CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials. Se FALSE, as credenciais não serão armazenadas e várias partes de memória serão limpas.

Retornar valor

O status da operação é retornado. O chamador pode marcar essa status para determinar se a operação de confirmação de credencial foi bem-sucedida. A maioria dos aplicativos ignora esse código status porque a conexão do aplicativo com o recurso já foi feita. A operação pode falhar porque a credencial não foi encontrada na lista de credenciais aguardando confirmação ou porque a tentativa de gravar ou excluir a credencial falhou. A falha ao localizar a credencial na lista pode ocorrer porque a credencial nunca foi enfileirada ou como resultado de muitas credenciais sendo enfileiradas. Até cinco credenciais podem ser enfileiradas antes que as mais antigas sejam descartadas à medida que as mais recentes forem enfileiradas.

Código de retorno	Descrição
NO_ERROR - (zero)	Confirme se a operação foi bem-sucedida.
ERROR_NOT_FOUND	Não foi possível encontrar a credencial de entidade na lista de espera de confirmação.
ERROR_INVALID_PARAMETER	Uma tentativa de confirmar uma credencial de espera falhou porque a credencial continha dados que não eram válidos ou inconsistentes.

Comentários

Observação

O cabeçalho wincred.h define CredUIConfirmCredentials como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wincred.h
Biblioteca	Credui.lib
DLL	Credui.dll