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
Capicom.dll

Voir aussi

Objets de chiffrement

EncryptedData