Fonction CredProtectA (wincred.h)

Article
08/27/2023

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 sur TRUE pour spécifier que les informations d’identification sont chiffrées dans le contexte de sécurité du processus actuel. Définissez sur 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, à la sortie, reçoit les informations d’identification chiffrées.

[in, out] pcchMaxChars

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

[out] ProtectionType

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

Valeur retournée

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.

Notes

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


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

Share via