CryptoManager
BeginEncrypting
Disponible desde la versión 8.3.6.
Variante de sintaxis: Datos en valor de retorno
Sintaxis:
BeginEncrypting(<CallbackDescription>, <SourceData>, <Recipients>)
Parámetros:
<CallbackDescription> (obligatorio)
Tipo: CallbackDescription.
Contiene una descripción del procedimiento que se llamará al completar el cifrado de datos con los siguientes parámetros:
- <SignedData> – datos cifrados del tipo BinaryData.
- <AdditionalParameters> – valor especificado cuando se creó el objeto CallbackDescription.
<SourceData> (obligatorio)
Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos fuente para el cifrado.
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.
<Recipients> (obligatorio)
Tipo: CryptoCertificate, Array.
El parámetro puede contener un certificado o un array de certificados.
Solo los destinatarios de la lista especificada (los destinatarios que han transferido certificados) podrán descifrar los datos utilizando sus claves privadas.
Descripción de la variante del método:
Realiza el cifrado de datos para usuarios definidos. Solo los usuarios de la lista definida pueden descifrar los datos utilizando sus claves.
El formato de los datos cifrados es CMS (basado en PKCS#7).
Utiliza el algoritmo especificado en la propiedad EncryptAlgorithm.
Después de completar el cifrado, se llama a un procedimiento especificado en el parámetro CallbackDescription.
El procedimiento indicado en el parámetro CallbackDescription debe contener los parámetros:
- <EncryptedData> – datos cifrados del tipo BinaryData.
- <AdditionalParameters>.
Variante de sintaxis: Guardar datos en un archivo
Sintaxis:
BeginEncrypting(<CallbackDescription>, <SourceData>, <OutputData>, <Recipients>)
Parámetros:
<CallbackDescription> (obligatorio)
Tipo: CallbackDescription.
Contiene una descripción del procedimiento que se llamará al completar el cifrado de datos con los siguientes parámetros:
- <FileName> – nombre del archivo en el que se colocan los datos.
- <AdditionalParameters> – valor especificado cuando se creó el objeto CallbackDescription.
<SourceData> (obligatorio)
Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos fuente para el cifrado.
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.
<OutputData> (obligatorio)
Tipo: String.
Nombre del archivo en el que se descargan los datos cifrados.
<Recipients> (obligatorio)
Tipo: CryptoCertificate, Array.
El parámetro puede contener un certificado o un array de objetos de certificado.
Solo los destinatarios de la lista especificada (los destinatarios que han transferido certificados) podrán descifrar los datos utilizando sus claves privadas.
Descripción de la variante del método:
Los datos cifrados se escriben en un archivo.
Descripción:
Inicia el cifrado de datos para usuarios definidos. Solo los usuarios de la lista definida pueden descifrar los datos utilizando sus claves.
El formato de los datos cifrados es CMS (basado en PKCS#7).
Utiliza el algoritmo especificado en la propiedad EncryptAlgorithm.
Después de completar el cifrado, se llama a un procedimiento con el nombre especificado en CallbackDescription.
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.
Ver también:
CryptoManager, método Encrypt
CryptoManager, método EncryptAsync
Disponible desde:
Disponible desde la versión 8.3.6.
Descripción cambiada en la versión 8.3.18.
