Método EncryptedData.SetSecret

[CAPICOM es un componente solo de 32 bits que está disponible para su uso en los siguientes sistemas operativos: Windows Server 2008, Windows Vista y Windows XP. En su lugar, use Servicios de invocación de plataforma (PInvoke) para llamar a las funciones de api de Win32 CryptEncryptMessage y CryptDecryptMessage para cifrar y descifrar mensajes. Para obtener información sobre PInvoke, vea Tutorial de invocación de plataforma. .NET y CryptoAPI a través de P/Invoke: parte 1 y .NET y CryptoAPI a través de P/Invoke: subsecciones de la parte 2 de extensión de criptografía de .NET con CAPICOM y P/Invoke también pueden ser útiles.]

El método SetSecret establece el valor del secreto utilizado para derivar la clave de sesión criptográfica utilizada para cifrar y descifrar datos.

Sintaxis

EncryptedData.SetSecret( _
  ByVal newVal, _
  [ ByVal SecretType ] _
)

Parámetros

newVal [in]

Cadena que contiene un secreto usado para crear una clave criptográfica de sesión.

SecretType [in, opcional]

Valor de la enumeración CAPICOM_SECRET_TYPE que indica el tipo de secreto usado para generar la clave de sesión. El valor predeterminado es CAPICOM_SECRET_PASSWORD. Este parámetro puede ser el siguiente valor.

Valor	Significado
CAPICOM_SECRET_PASSWORD	La clave de cifrado se va a derivar de una contraseña.

 

Valor devuelto

Este método no devuelve ningún valor.

Comentarios

El secreto se usa para crear la clave de sesión para el cifrado o descifrado. Se debe usar el mismo secreto para ambas operaciones. Si se pierde el secreto usado para cifrar los datos, no se pueden descifrar los datos cifrados.

Si es adecuado para la aplicación, considere la posibilidad de usar CryptProtectMemory o CryptProtectData para proteger el secreto antes y después de su uso. Borre la memoria asociada al secreto cuando haya terminado.

Requisitos

Requisito	Value
Fin de compatibilidad de cliente	Windows Vista
Fin de compatibilidad de servidor	Windows Server 2008
Redistribuible	CAPICOM 2.0 o posterior en Windows Server 2003 y Windows XP
Archivo DLL	Capicom.dll

Consulte también

Objetos criptográficos

EncryptedData