Fonction CredUIConfirmCredentialsA (wincred.h)

Article
08/27/2023

La fonction CredUIConfirmCredentials est appelée après CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials, pour confirmer la validité des informations d’identification collectées. CredUIConfirmCredentials doit être appelé si l’indicateur CREDUI_FLAGS_EXPECT_CONFIRMATION a été passé à la fonction « prompt », CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials, et la fonction « prompt » retournée NO_ERROR.

Après avoir appelé la fonction « prompt » et avant d’appeler CredUIConfirmCredentials, l’appelant doit déterminer si les informations d’identification sont réellement valides en utilisant les informations d’identification pour accéder à la ressource spécifiée par pszTargetName. Les résultats de ce test de validation sont transmis à CredUIConfirmCredentials dans le paramètre bConfirm .

Syntaxe

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

Paramètres

[in] pszTargetName

Pointeur vers une chaîne terminée par null qui contient le nom de la cible pour les informations d’identification, généralement un nom d’application de domaine ou de serveur. Il doit s’agir de la même valeur passée que pszTargetName à CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials

[in] bConfirm

Spécifie si les informations d’identification retournées par la fonction d’invite sont valides. Si la valeur est TRUE, les informations d’identification sont stockées dans le gestionnaire d’informations d’identification tel que défini par CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials. Si la valeur est FALSE, les informations d’identification ne sont pas stockées et diverses parties de mémoire sont nettoyées.

Valeur retournée

L’état de l’opération est retourné. L’appelant peut case activée cette status pour déterminer si l’opération de confirmation des informations d’identification a réussi. La plupart des applications ignorent ce code status, car la connexion de l’application à la ressource a déjà été établie. L’opération peut échouer, car les informations d’identification sont introuvables dans la liste des informations d’identification en attente de confirmation, ou parce que la tentative d’écriture ou de suppression des informations d’identification a échoué. L’échec de la recherche des informations d’identification dans la liste peut se produire parce que les informations d’identification n’ont jamais été mises en file d’attente ou en raison d’un trop grand nombre d’informations d’identification mises en file d’attente. Jusqu’à cinq informations d’identification peuvent être mises en file d’attente avant que les anciennes ne soient ignorées, car les informations plus récentes sont mises en file d’attente.

Code de retour	Description
NO_ERROR - (zéro)	Confirmez la réussite de l’opération.
ERROR_NOT_FOUND	Les informations d’identification du sujet sont introuvables dans la liste d’attente de confirmation.
ERROR_INVALID_PARAMETER	Une tentative de confirmation des informations d’identification en attente a échoué, car les informations d’identification contenaient des données non valides ou incohérentes.

Remarques

Notes

L’en-tête wincred.h définit CredUIConfirmCredentials en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wincred.h
Bibliothèque	Credui.lib
DLL	Credui.dll

Share via