Função CredUIConfirmCredentialsA (wincred.h)

Artigo
11/20/2024

A função credUIConfirmCredentials é chamada após CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials, para confirmar a validade da credencial colhida. CredUIConfirmCredentials deverá ser chamado se o sinalizador CREDUI_FLAGS_EXPECT_CONFIRMATION tiver sido passado para a função "prompt", CredUIPromptForCredentials ou CredUICmdLinePromptForCredentialse 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 um cadeia de caracteresterminada nula 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 que 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 da memória serão limpas.

Valor de retorno

O status da operação é retornado. O chamador pode verificar esse status para determinar se a operação de confirmação de credencial foi bem-sucedida. A maioria dos aplicativos ignora esse código de 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. 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	A credencial do assunto não pôde ser encontrada na lista de espera de confirmação.
ERROR_INVALID_PARAMETER	Falha na tentativa de confirmar uma credencial de espera porque a credencial continha dados que não eram válidos ou inconsistentes.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wincred.h
biblioteca	Credui.lib
de DLL	Credui.dll

Compartilhar via