CryptoManager.BeginDecrypting

CryptoManager

BeginDecrypting

Disponible desde la versión 8.3.6.

Variante de sintaxis: Datos en formato binario

Sintaxis:

BeginDecrypting(<CallbackDescription>, <SourceData>, <Certificate>, <PrivateKeyAccessPassword>)

Parámetros:

<CallbackDescription> (obligatorio)

Tipo: CallbackDescription.
Contiene una descripción del procedimiento que se llamará al completar la desencriptación con los siguientes parámetros:

  • <DecryptedData> – datos desencriptados del tipo BinaryData.
  • <AdditionalParameters> – valor especificado cuando se creó el objeto CallbackDescription.

<SourceData> (obligatorio)

Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos encriptados.
Los datos pueden estar ubicados en un archivo (en este caso se especifica el nombre del archivo) o representados como BinaryData, Stream, MemoryStream o FileStream.

<Certificate> (opcional)

Tipo: CryptoCertificate.
Certificado del destinatario de los datos encriptados para quien se está desencriptando los datos.

<PrivateKeyAccessPassword> (opcional)

Tipo: String.
Contraseña para acceder a un contenedor de claves del destinatario de los datos encriptados.

Descripción de la variante del método:

Transfiere los datos desencriptados en el parámetro del tipo BinaryData.

Variante de sintaxis: Guardar datos en un archivo

Sintaxis:

BeginDecrypting(<CallbackDescription>, <SourceData>, <Certificate>, <PrivateKeyAccessPassword>)

Parámetros:

<CallbackDescription> (obligatorio)

Tipo: CallbackDescription.
Contiene una descripción del procedimiento que se llamará al completar la desencriptación de datos con los siguientes parámetros:

  • <FileName> – nombre del archivo de salida con los datos desencriptados.
  • <AdditionalParameters> – valor especificado cuando se creó el objeto CallbackDescription.

<FileName> – nombre del archivo de salida con los datos desencriptados.
<AdditionalParameters> – valor especificado cuando se creó el objeto CallbackDescription.

<SourceData> (obligatorio)

Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos encriptados.
Los datos pueden estar ubicados en un archivo (en este caso se especifica el nombre del archivo) o representados como BinaryData, Stream, MemoryStream o FileStream.

<Certificate> (opcional)

Tipo: CryptoCertificate.
Certificado del destinatario de los datos encriptados para quien se está desencriptando los datos.

<PrivateKeyAccessPassword> (opcional)

Tipo: String.
Contraseña para acceder a un contenedor de claves del destinatario de los datos encriptados.

Descripción del método:

Comienza a desencriptar los datos encriptados.
Para una encriptación de datos adecuada, es necesario que:

  • El certificado vinculado con el contenedor de claves privadas esté instalado en el repositorio de certificados personales.
  • El certificado debe especificarse como uno de los destinatarios de los datos encriptados (descrito en el parámetro <RecipientList> del método Encrypt).

Disponibilidad:

Cliente ligero, cliente web, cliente móvil, servidor, cliente grueso, conexión externa, aplicación móvil (cliente), aplicación móvil (servidor), servidor independiente móvil.

Nota:

Se genera una situación excepcional en caso de error.

Consulte también:

CryptoManager, método Decrypt
CryptoManager, método DecryptAsync

Disponible desde:

Disponible desde la versión 8.3.6.

Descripción cambiada en la versión 8.3.24.