Méthode EncryptedData.SetSecret

[CAPICOM est un composant 32 bits uniquement disponible pour une utilisation dans les systèmes d’exploitation suivants : Windows Server 2008, Windows Vista et Windows XP. Utilisez plutôt Platform Invocation Services (PInvoke) pour appeler les fonctions d’API Win32 CryptEncryptMessage et CryptDecryptMessage pour chiffrer et déchiffrer les messages. Pour plus d’informations sur PInvoke, consultez Tutoriel sur l’appel de plateforme. Les sous-sections .NET et CryptoAPI via P/Invoke : Partie 1 et .NET et CryptoAPI via P/Invoke : Partie 2 de l’extension du chiffrement .NET avec CAPICOM et P/Invoke peuvent également être 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 [in]

Chaîne qui contient un secret utilisé pour créer une clé de chiffrement de session.

SecretType [in, facultatif]

Valeur de l’énumération CAPICOM_SECRET_TYPE qui indique le type de secret utilisé pour générer la clé de session. La valeur par défaut est CAPICOM_SECRET_PASSWORD. Ce paramètre peut être la valeur suivante.

Valeur	Signification
CAPICOM_SECRET_PASSWORD	La clé de chiffrement doit être dérivée d’un mot de passe.

 

Valeur retournée

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. Le même secret doit être utilisé 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 cela est approprié pour votre application, envisagez d’utiliser CryptProtectMemory ou CryptProtectData pour protéger le secret avant et après l’utilisation. Effacez la mémoire associée au secret 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