CryptoManager

BeginSigning

Variante de sintaxis: Datos de firma en valor de retorno

Sintaxis:

BeginSigning(<CallbackDescription>, <InitialData>, <Certificate>, <SignatureType>)

Parámetros:

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

• <SignedData> – para datos de firma del tipo BinaryData.
• <AdditionalParameters> – valor especificado cuando se creó el objeto CallbackDescription.

Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos iniciales para firmar.
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.

Tipo: CryptoCertificate.
Certificado de criptografía utilizado.
Si no se especifica, el almacén de certificados personales debe contener exactamente un certificado. De lo contrario, se generará una excepción descrita en el objeto CallbackDescription.

Tipo: CryptoSignatureType.
Tipo de firma de criptografía.
{macros: Tipos de firma admitidos}
Valor predeterminado: CAdESBES.

Descripción de la variante del método:

Comienza a crear la firma en formato CMS (basado en PKCS#7) y la devuelve como BinaryData o la guarda en un archivo.
La firma se crea mediante algoritmos que se establecen mediante las propiedades HashAlgorithm y SignAlgorithm.
El archivo fuente no se incluye en los datos de firma.
Los certificados pueden incluirse en los datos de firma según la propiedad IncludeCertificatesInSignature.
Si no se indica el certificado, se utilizará el único certificado personal instalado para la firma.
Al finalizar, se llamará al procedimiento indicado en CallbackDescription. El procedimiento debe tener los siguientes parámetros:

• <SignedData> – para datos de firma del tipo BinaryData.
• <AdditionalParameters>.

Variante de sintaxis: Los datos se guardan en un archivo

Sintaxis:

BeginSigning(<CallbackDescription>, <InitialData>, <OutputData>, <Certificate>, <SignatureType>)

Parámetros:

Tipo: CallbackDescription.
Contiene la descripción del procedimiento que se llamará después de que se complete la firma de datos con los siguientes parámetros:

• <FileName> – un nombre de archivo de salida.
• <AdditionalParameters> – el valor especificado cuando se crea el objeto CallbackDescription.

Tipo: String, BinaryData, Stream, MemoryStream, FileStream.
Datos iniciales para firmar.
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.

Tipo: String.
Nombre del archivo al que se descargan los datos firmados.

Tipo: CryptoCertificate.
Certificado de criptografía utilizado.
Si no se especifica, se generará una excepción.

Tipo: CryptoSignatureType.
Tipo de firma de criptografía.
{macros: Tipos de firma admitidos}
Valor predeterminado: CAdESBES.

Descripción de la variante del método:

Los datos firmados se escriben en un archivo.

Descripción:

Genera una firma en formato CMS (basado en PKCS#7) y luego la devuelve como un objeto de tipo BinaryData, o la guarda en un archivo.
Las propiedades HashAlgorithm y SignAlgorithm definen los algoritmos de firma.
El archivo fuente no se incluye en los datos de firma.
La propiedad IncludeCertificatesInSignature especifica si los certificados se incluirán en la firma.
Si no se especifica el certificado, se utilizará el certificado personal.
Después de completar, se llama a un procedimiento especificado en el parámetro &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.

Véase también:

CryptoManager, método Sign
CryptoManager, método SignAsync

Disponible desde:

Disponible desde la versión 8.3.6.

Descripción cambiada en la versión 8.3.21.

---