CredUIConfirmCredentialsA, fonction (wincred.h)

Article
11/20/2024

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ée si l’indicateur CREDUI_FLAGS_EXPECT_CONFIRMATION a été passé à la fonction « prompt », soit 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 à l’aide des informations d’identification pour accéder à la ressource spécifiée par pszTargetName. Les résultats de ce test de validation sont passés à 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 null-terminated 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 que pszTargetName à CredUIPromptForCredentials ou CredUICmdLinePromptForCredentials

[in] bConfirm

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

Valeur de retour

L’état de l’opération est retourné. L’appelant peut vérifier cet état pour déterminer si l’opération de confirmation des informations d’identification a réussi. La plupart des applications ignorent ce code d’état, car la connexion de l’application à la ressource a déjà été effectuée. L’opération peut échouer, car les informations d’identification n’ont pas été trouvées 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, car 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 anciens ne soient ignorés, car les informations d’identification plus récentes sont mises en file d’attente.

Retourner le code	Description
NO_ERROR - (zéro)	Confirmez que l’opération a réussi.
ERROR_NOT_FOUND	Les informations d’identification de l’objet 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 qui n’étaient pas valides ou incohérentes.

Remarques

Note

L’en-tête wincred.h définit CredUIConfirmCredentials comme 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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wincred.h
bibliothèque	Credui.lib
DLL	Credui.dll

Partager via