SaveAsPadesDss - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Saves the active PDF to a file while embedding PAdES Document Security Store (DSS) validation certificates

Syntax

function SaveAsPadesDss(const FileName: string; const Options: TPadesDssOptions): Boolean; overload;

Description

Saves the current document bytes into a file while injecting X.509 validation materials (certificates, CRLs, and OCSP responses) into the document's global /DSS dictionary

TPadesDssOptions.Vris can associate selected material with each signature through indirect /Type /VRI dictionaries keyed by the uppercase SHA-1 of the complete decoded signature /Contents value, including any padding bytes

Requires Active to be True; returns False if the save operation fails

Parameters

FileName	Absolute or relative path to the destination file
Options	Complete DSS configuration containing DER material arrays, signature-specific VRI index lists, and extension settings

Remarks

This represents stage 4 of validation-material embedding, necessary to transition a B-T signature level to a long-term B-LT or B-LTA level
The original document is saved as a new file via an incremental update containing the added /DSS markers
The incremental update preserves the source xref table or xref-stream representation and uses 64-bit offsets in 64-bit builds
Duplicate certificates, OCSP responses, and CRLs are written once and every VRI index is remapped to the retained stream object
All VRI entries and indexes are validated before output begins; an invalid index, empty material, empty signature value, or duplicate signature identifier raises EPadesCrypto without modifying the destination
The supplied options define the complete replacement DSS; include every VRI and material entry that the output must retain when replacing an existing active DSS

Example

var
  DssOpts: TPadesDssOptions;
begin
  if not Pdf1.Active then Exit;
  DssOpts := TPadesDssOptions.Default;
  // populate DssOpts.Certs with DER validation certificates
  Pdf1.SaveAsPadesDss('signed-blt.pdf', DssOpts);
end;

SaveAsPadesDss method