Fonction CredUnprotectA (wincred.h)

Article
03/03/2024

La fonction CredUnprotect déchiffre les informations d’identification précédemment chiffrées à l’aide de la fonction CredProtect . Les informations d’identification doivent avoir été chiffrées dans le même contexte de sécurité dans lequel CredUnprotect est appelé.

Syntaxe

BOOL CredUnprotectA(
  [in]      BOOL  fAsSelf,
  [in]      LPSTR pszProtectedCredentials,
  [in]      DWORD cchProtectedCredentials,
  [out]     LPSTR pszCredentials,
  [in, out] DWORD *pcchMaxChars
);

Paramètres

[in] fAsSelf

Définissez sur TRUE pour spécifier que les informations d’identification ont été chiffrées dans le contexte de sécurité du processus en cours. Définissez sur FALSE pour spécifier que les informations d’identification ont été chiffrées dans le contexte de sécurité du contexte de sécurité du thread appelant.

[in] pszProtectedCredentials

Pointeur vers une chaîne qui spécifie les informations d’identification chiffrées.

[in] cchProtectedCredentials

Taille, en caractères, de la mémoire tampon pszProtectedCredentials .

[out] pszCredentials

Pointeur vers une chaîne qui, lors de la sortie, reçoit les informations d’identification déchiffrées.

[in, out] pcchMaxChars

Taille, en caractères de la mémoire tampon pszCredentials . En sortie, si pszCredentials n’est pas de taille suffisante pour recevoir les informations d’identification chiffrées, ce paramètre spécifie la taille requise, en caractères, de la mémoire tampon pszCredentials .

Valeur retournée

TRUE si la fonction réussit ; sinon, FALSE.

Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError . Le tableau suivant montre les valeurs courantes pour la fonction GetLastError .

Code/valeur de retour	Description
ERROR_NOT_CAPABLE	Le contexte de sécurité utilisé pour chiffrer les informations d’identification est différent du contexte de sécurité utilisé pour déchiffrer les informations d’identification.
ERROR_INSUFFICIENT_BUFFER	La mémoire tampon pszCredentials était de taille insuffisante.

Remarques

Notes

L’en-tête wincred.h définit CredUnprotect comme un 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.

Configuration requise

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

Partager via