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. credUIConfirmCredentials debe llamarse si la marca CREDUI_FLAGS_EXPECT_CONFIRMATION se pasó a la función "prompt", ya sea CredUIPromptForCredentials o CredUICmdLinePromptForCredentialsy la función "prompt" devolvió NO_ERROR.

Después de llamar a la función "prompt" y antes de llamar a CredUIConfirmCredentials, el llamador 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 un cadena terminada en nullque contiene el nombre del destino para las credenciales, normalmente un nombre de aplicación de dominio o servidor. Debe ser el mismo valor pasado que pszTargetName a CredUIPromptForCredentials o CredUICmdLinePromptForCredentials

[in] bConfirm

Especifica si las credenciales devueltas de la función prompt son válidas. Si TRUE, las credenciales se almacenan en el administrador de credenciales tal y como se define en CredUIPromptForCredentials o CredUICmdLinePromptForCredentials. Si 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 al intentar escribir o eliminar la credencial. Se puede producir un error al 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 ha realizado 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.

Observaciones

Nota

El encabezado wincred.h define CredUIConfirmCredentials como 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wincred.h
biblioteca de	Credui.lib
DLL de	Credui.dll