CredProtectA, fonction (wincred.h)

Article
11/20/2024

La fonction CredProtect chiffre les informations d’identification spécifiées afin que seul le contexte de sécurité actuel puisse les déchiffrer.

Syntaxe

BOOL CredProtectA(
  [in]      BOOL                 fAsSelf,
  [in]      LPSTR                pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPSTR                pszProtectedCredentials,
  [in, out] DWORD                *pcchMaxChars,
  [out]     CRED_PROTECTION_TYPE *ProtectionType
);

Paramètres

[in] fAsSelf

Définissez la valeur TRUE pour spécifier que les informations d’identification sont chiffrées dans le contexte de sécurité du processus actuel. Définissez la valeur FALSE pour spécifier que les informations d’identification sont chiffrées dans le contexte de sécurité du contexte de sécurité du thread appelant.

[in] pszCredentials

Pointeur vers une chaîne qui spécifie les informations d’identification à chiffrer. La fonction chiffre le nombre de caractères fournis dans le paramètre cchCredentials.

[in] cchCredentials

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

[out] pszProtectedCredentials

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

[in, out] pcchMaxChars

Taille, en caractères de la mémoire tampon pszProtectedCredentials tampon. En sortie, si les pszProtectedCredentials ne sont 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 pszProtectedCredentials.

[out] ProtectionType

Pointeur vers un type d’énumération CRED_PROTECTION_TYPE qui, lors de la sortie, spécifie le type de protection fourni.

Valeur de retour

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

Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError.

Remarques

Notez que la sortie de la fonction CredProtect n’est pas protégée par l’intégrité. Par conséquent, si la sortie est modifiée, la fonction CredUnprotect n’est pas mise à jour et peut produire des résultats incorrects.

Note

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