THPDFWindowsFormDataTransaction.RemoveAnnotations-Methode

procedure RemoveAnnotations(
  const Identities: array of THPDFHeadlessAnnotationIdentity;
  const Options: THPDFHeadlessAnnotationRemovalOptions;
  const Password: AnsiString);

Bereitet einen Entfernungskandidaten über die native authentifizierte Engine vor, ohne das geliehene THotPDF-Dokument der Transaktion zu verändern

Die Transaktion muss mit der tatsächlichen originalen Quelle konstruiert worden sein, die dem geladenen Dokument entspricht, und mit dem Passwort, das zur Authentifizierung verschlüsselter Eingabe benötigt wird

ChangedAnnotations berichtet die Anzahl der Entfernungen, einschließlich Kaskadenabhängigkeiten; der Zähler nutzt den vorhandenen Vorbereitungs-Änderungsspeicher der Transaktion

Nach der Vorbereitung kopiert WritePreparedPDF den begrenzten Kandidaten in einen Zielstream; rufen Sie TakeCandidate erst auf, nachdem jede erforderliche PDF- und Ergebnisveröffentlichung erfolgreich war

TakeCandidate überträgt das neue THotPDF und seine besitzende THPDFWindowsFormDataSource; zerstören Sie das Dokument vor seiner Quelle

Ein Fehlschlag oder Abbruch bedeutet, die Transaktion zu verwerfen und das geliehene Dokument und die Quelle zu behalten; eine Transaktion mit bereits vorbereitetem Kandidaten weist eine weitere Vorbereitung zurück

Bei null Entfernungen ist die Ausgabe die exakte aktuelle vorbereitete Revision, einschließlich des durch die Transaktion dargestellten ausstehenden geladenen Dokumentzustands; es ist nicht notwendigerweise die ursprüngliche Datei auf der Festplatte, wenn der Aufrufer ungespeicherte Änderungen hatte

Grenzen und Identität

Seiten- und Namensauswahl, Abhängigkeitskaskaden, Mehrdeutigkeitsprüfungen und die Widget-Grenze folgen der nativen Annotation-Entfernung

Ein explizit geliefertes Cancellation-Token muss das Token der Transaktion sein; die Transaktion begrenzt MaxWorkingBytes auf die Hälfte ihrer Arbeitskapazität und MaxAnnotations auf ihre Objektkapazität

Die Methode bewahrt Positive-Kapazitätsprüfungen, verschlüsselte Annotation-Berechtigungen und authentifizierte Signatur-Policy-Zulassung; das Passwort ist keine Autorisierungsumgehung

Siehe gewöhnliche Windows-Entfernung und THPDFWindowsFormDataTransaction für Eigentümerschafts- und Lebenszyklusdetails