RenewPadesArchiveTimestamp - TPdf - PDFium Delphi Component

元件: TPdf · 單元: PDFium

將新的封存 Document Time-stamp 附加到既有的 PAdES 簽章鏈結

Syntax

function RenewPadesArchiveTimestamp(const FileName: string; const Options: TPadesArchiveTimestampOptions; out Report: TPadesArchiveTimestampReport): Boolean;

function RenewPadesArchiveTimestampToStream(Stream: TStream; const Options: TPadesArchiveTimestampOptions; out Report: TPadesArchiveTimestampReport): Boolean;

Description

讀取作用中元件保留的原始檔案、記憶體緩衝區、自訂資料流或已完成的漸進式來源，並附加增量式的 RFC 3161 Document Time-stamp，其 ByteRange 涵蓋所有先前的修訂版本

當 UpdateDss 為 True 時，會在時間戳記之前附加所提供的完整憑證、OCSP、CRL 與 VRI 資料，使回傳的權杖保護更新後的長期驗證狀態

只有在附加欄位可被探索且結構驗證回報 PAdES B-LTA 之後，才會寫入輸出

Parameters

FileName	由完整暫存結果寫入的目的地路徑
Stream	目的地資料流，只有在成功更新後才會清除並填入
Options	TSA URL、nonce、權杖容量，以及可選的完整 DSS 替換資料
Report	來源與結果等級、時間戳記計數、位元組長度、DSS 更新狀態、產生時間、政策 OID 與 nonce

Remarks

需要 Active 為 True，且 TsaUrl 指向可用的 RFC 3161 服務
結果描述並延伸原始載入的版本，而非元件目前持有的未儲存編輯
加密輸入與未完成的漸進式輸入會被拒絕
既有輸入必須已宣告 ESIC ExtensionLevel 2，除非 UpdateDss 為 True
DSS 更新會替換作用中的目錄參考，因此 DssOptions 必須包含所有必須保持可用的憑證與驗證項目
ContentsSize 會被夾制到至少 1024 bytes，並限制為 16 MiB
歷史修訂版本保持逐位元組不變，因為每項更新都是附加的
當需要最新的憑證、撤銷或歷史信任決策時，請另行使用 ValidatePades 與線上信任政策

Example

var
  Options: TPadesArchiveTimestampOptions;
  Report: TPadesArchiveTimestampReport;
begin
  Options := TPadesArchiveTimestampOptions.Default;
  Options.TsaUrl := 'https://tsa.example.test';
  Options.Nonce := 42;
  if Pdf1.RenewPadesArchiveTimestamp('renewed.pdf', Options, Report) then
    ShowMessage(Format('%d archival timestamps', [Report.ResultDocTimeStampCount]));
end;

RenewPadesArchiveTimestamp 方法