CredUnprotectA, fonction (wincred.h)

Article
11/20/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ée.

Syntaxe

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

Paramètres

[in] fAsSelf

Défini sur TRUE pour spécifier que les informations d’identification ont été chiffrées dans le contexte de sécurité du processus actuel. Définissez la valeur 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 tampon.

[out] pszCredentials

Pointeur vers une chaîne qui, en 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 le 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 de retour

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

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

Retourner le code/la valeur	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

Note

L’en-tête wincred.h définit CredUnprotect 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 Vista [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2008 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wincred.h
bibliothèque	Advapi32.lib
DLL	Advapi32.dll

Partager via