EncryptedData. SetSecret, méthode
[capicom est un composant uniquement de 32 bits qui peut être utilisé dans les systèmes d’exploitation suivants : Windows Server 2008, Windows Vista et Windows XP. Utilisez plutôt les services d’appel de code non managé (PInvoke) pour appeler les fonctions de l’API Win32 CryptEncryptMessage et CryptDecryptMessage pour chiffrer et déchiffrer les messages. Pour plus d’informations sur PInvoke, consultez Didacticiel sur l’appel de code non managé. Le .net et CryptoAPI via p/Invoke : part 1 et .net et CryptoAPI via p/Invoke : partie 2 sous-sections de l' extension du chiffrement .net avec CAPICOM et P/Invoke peuvent également s’avérer utiles.]
La méthode SetSecret définit la valeur du secret utilisé pour dériver la clé de session de chiffrement utilisée pour chiffrer et déchiffrer les données.
Syntaxe
EncryptedData.SetSecret( _
ByVal newVal, _
[ ByVal SecretType ] _
)
Paramètres
-
newVal [ dans]
-
Chaîne qui contient un secret utilisé pour créer une clé de chiffrement de session.
-
SecretType [ dans, facultatif]
-
Valeur de l’énumération de _ _ type secret CAPICOM qui indique le type de secret utilisé pour générer la clé de session. La valeur par défaut est CAPICOM _ secret secret _ . Ce paramètre peut avoir la valeur suivante.
Valeur Signification - _ _ mot de passe secret de CAPICOM
La clé de chiffrement doit être dérivée d’un mot de passe.
Valeur de retour
Cette méthode ne retourne pas de valeur.
Notes
Le secret est utilisé pour créer la clé de session pour le chiffrement ou le déchiffrement. La même clé secrète doit être utilisée pour les deux opérations. Si le secret utilisé pour chiffrer les données est perdu, les données chiffrées ne peuvent pas être déchiffrées.
Si c’est approprié pour votre application, envisagez d’utiliser CryptProtectMemory ou CryptProtectData pour protéger la clé secrète avant et après l’utilisation. Effacez la mémoire associée à la clé secrète lorsque vous avez terminé.
Spécifications
| Condition requise | Valeur |
|---|---|
| Fin de la prise en charge des clients |
Windows Vista |
| Fin de la prise en charge des serveurs |
Windows Server 2008 |
| Composant redistribuable |
capicom 2,0 ou version ultérieure sur Windows Server 2003 et Windows XP |
| DLL |
|