Función CredUIConfirmCredentialsA (wincred.h)

Se llama a la función CredUIConfirmCredentials después de CredUIPromptForCredentials o CredUICmdLinePromptForCredentials, para confirmar la validez de la credencial cosechada. Se debe llamar a CredUIConfirmCredentials si la marca de CREDUI_FLAGS_EXPECT_CONFIRMATION se pasó a la función "prompt", ya sea CredUIPromptForCredentials o CredUICmdLinePromptForCredentials y la función "prompt" devolvió NO_ERROR.

Después de llamar a la función "prompt" y antes de llamar a CredUIConfirmCredentials, el autor de la llamada debe determinar si las credenciales son realmente válidas mediante las credenciales para acceder al recurso especificado por pszTargetName. Los resultados de esa prueba de validación se pasan a CredUIConfirmCredentials en el parámetro bConfirm .

Sintaxis

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

Parámetros

[in] pszTargetName

Puntero a una cadena terminada en null que contiene el nombre del destino para las credenciales, normalmente un nombre de aplicación de dominio o servidor. Debe ser el mismo valor que pszTargetName a CredUIPromptForCredentials o CredUICmdLinePromptForCredentials.

[in] bConfirm

Especifica si las credenciales devueltas de la función prompt son válidas. Si es TRUE, las credenciales se almacenan en el administrador de credenciales tal y como se define en CredUIPromptForCredentials o CredUICmdLinePromptForCredentials. Si es FALSE, las credenciales no se almacenan y se limpian varios fragmentos de memoria.

Valor devuelto

Se devuelve el estado de la operación. El autor de la llamada puede comprobar este estado para determinar si la operación de confirmación de credenciales se realizó correctamente. La mayoría de las aplicaciones omiten este código de estado porque ya se ha realizado la conexión de la aplicación al recurso. Se puede producir un error en la operación porque no se encontró la credencial en la lista de credenciales en espera de confirmación o porque se produjo un error en el intento de escribir o eliminar la credencial. No se puede encontrar la credencial en la lista porque la credencial nunca se puso en cola o como resultado de que se ponen en cola demasiadas credenciales. Se pueden poner en cola hasta cinco credenciales antes de que las más antiguas se descarten a medida que se ponen en cola las más recientes.

Código devuelto	Descripción
NO_ERROR: (cero)	Confirme que la operación se realizó correctamente.
ERROR_NOT_FOUND	No se encontró la credencial del firmante en la lista de espera de confirmación.
ERROR_INVALID_PARAMETER	Error al intentar confirmar una credencial en espera porque la credencial contenía datos que no eran válidos o no eran incoherentes.

Comentarios

Nota

El encabezado wincred.h define CredUIConfirmCredentials como un alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincred.h
Library	Credui.lib
Archivo DLL	Credui.dll