SaveAsPadesDss - TPdf

元件: TPdf · 單元: PDFium

在內嵌 PAdES 文件安全存放區 (DSS) 驗證憑證的同時，將作用中的 PDF 儲存至檔案

Syntax

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

Description

在將 X.509 驗證資料（憑證、CRL 與 OCSP 回應）注入文件全域 /DSS 字典的同時，將目前文件位元組儲存至檔案

TPadesDssOptions.Vris 可透過間接 /Type /VRI 字典，將選定的資料與每個簽章關聯，字典以完整解碼之簽章 /Contents 值（含任何填充位元組）的大寫 SHA-1 為索引鍵

需要 Active 為 True；若儲存操作失敗則傳回 False

Parameters

FileName	目的檔案的絕對或相對路徑
Options	完整的 DSS 組態，包含 DER 資料陣列、簽章特定的 VRI 索引清單與延伸設定

Remarks

這代表驗證資料內嵌的第 4 階段，這是將 B-T 簽章層級轉換為長期 B-LT 或 B-LTA 層級所必需
原始文件會透過包含已新增 /DSS 標記的增量更新，儲存為新檔案
增量更新會保留來源的 xref 表格或 xref 串流表示，並在 64 位元組建中使用 64 位元位移
重複的憑證、OCSP 回應與 CRL 只會寫入一次，且每個 VRI 索引都會重新對應到保留的串流物件
所有 VRI 項目與索引都會在輸出開始前驗證；無效索引、空資料、空簽章值或重複的簽章識別碼會引發 EPadesCrypto，且不會修改目的地
提供的選項會定義完整的替換 DSS；在替換既有作用中 DSS 時，請包含輸出必須保留的每個 VRI 與資料項目

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 方法