Fonction CredProtectA (wincred.h)
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 |