Fonction CredProtectW (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 CredProtectW(
  [in]      BOOL                 fAsSelf,
  [in]      LPWSTR               pszCredentials,
  [in]      DWORD                cchCredentials,
  [out]     LPWSTR               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 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, lors de 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, en 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 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