RenewPadesArchiveTimestamp - TPdf - PDFium Delphi Component

Komponente: TPdf · Unit: PDFium

Hängt einen neuen Archiv-Dokumentzeitstempel an eine vorhandene PAdES-Signaturkette an.

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

Liest die exakte ursprüngliche Datei, den Speicherpuffer, den benutzerdefinierten Stream oder die abgeschlossene progressive Quelle, die die aktive Komponente hält, und hängt einen inkrementellen RFC 3161-Dokumentzeitstempel an, dessen ByteRange jede frühere Revision abdeckt

Bei UpdateDss gleich True wird das gelieferte vollständige Zertifikats-, OCSP-, CRL- und VRI-Material vor dem Zeitstempel angehängt, sodass das zurückgegebene Token den aufgefrischten Langzeitvalidierungszustand schützt

Die Ausgabe wird erst geschrieben, nachdem das angehängte Feld auffindbar ist und die Strukturvalidierung PAdES B-LTA meldet

Parameters

FileName	Zielpfad, der aus einem vollständig vorbereiteten Ergebnis geschrieben wird
Stream	Ziel-Stream, der erst nach erfolgreicher Erneuerung geleert und gefüllt wird
Options	TSA-URL, Nonce, Token-Kapazität und optionales vollständiges DSS-Ersatzmaterial
Report	Quell- und Ergebnisebenen, Zeitstempelanzahlen, Bytelängen, DSS-Aktualisierungszustand, Erzeugungszeit, Richtlinien-OID und Nonce

Remarks

Erfordert Active gleich True und dass TsaUrl einen verfügbaren RFC 3161-Dienst benennt
Das Ergebnis beschreibt und erweitert die ursprünglich geladene Version, nicht die derzeit von der Komponente gehaltenen ungespeicherten Bearbeitungen
Verschlüsselte Eingaben und unvollständige progressive Eingaben werden abgewiesen
Die vorhandene Eingabe muss bereits ESIC ExtensionLevel 2 deklarieren, sofern UpdateDss nicht True ist
Eine DSS-Auffrischung ersetzt die aktive Katalogreferenz; daher muss DssOptions jedes Zertifikat und Validierungselement enthalten, das verfügbar bleiben muss
ContentsSize wird auf mindestens 1024 Bytes begrenzt und auf 16 MiB limitiert
Historische Revisionen bleiben Byte für Byte unverändert, weil jede Aktualisierung angehängt wird
Verwenden Sie ValidatePades und eine Online-Vertrauensrichtlinie unabhängig davon, wenn aktuelle Zertifikats-, Sperr- oder historische Vertrauensentscheidungen erforderlich sind

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 Methode