THotPDF.SaveIncrementalUpdate

THotPDF

 

Föregående  Metoder  THotPDF

Skriver de ursprungliga PDF-byten följda av ändrade objekt, ett nytt xref-underavsnitt och en trailer med en /Prev-pekare

 

Delphi syntax:

procedure SaveIncrementalUpdate(const TargetFile: TFileName);

 

C++ syntax:

void __fastcall SaveIncrementalUpdate(System::Sysutils::TFileName TargetFile);

 

procedure SaveIncrementalUpdate(const TargetFile: TFileName); overload;

Bounded overload

procedure SaveIncrementalUpdate(const TargetFile: TFileName;
  MaxOutputBytes: Int64; Checkpoint: TNotifyEvent); overload;

Ett positivt MaxOutputBytes kräver BeginIncrementalUpdate och begränsar hela det ursprungliga prefixet plus tillagd delta; negativa gränser är ogiltiga, medan noll behåller det äldre obegränsade beteendet

Överloaden med positiv gräns spoolar sin delta till tillfällig lagring och kastar EHPDFIncrementalOutputBudget före publicering när serialiseringen överskrider taket, med bevarande av befintligt mål i det fallet

Checkpoint tar emot dokumentet under objekttraversering och publiceringskopiering, och den interna spoolen under skrivningar; bero inte av en specifik Sender-typ

Denna lågnivåsparande är inte ett atomärt ersättnings-API för ett fristående mål; avbrott eller ett I/O-fel under publiceringen kan lämna en partiell fil, så använd en privat kandidat eller det validerade inkrementella signeringsjobbet för atomär extern publicering

Beskrivning

SaveIncrementalUpdate slutför arbetsflödet som startades av BeginIncrementalUpdate. Källbyten kopieras oförändrat, så befintliga byteintervall och tidigare signaturer förblir intakta. Endast ändrade objekt läggs till i slutet av målfilen/Prev pekar på föregående revision

För ett annat mål kopieras originalprefixet sekventiellt från den filbaserade källan innan den färdiga deltalog läggs till. För samma mål validerar HotPDF källans identitet, längd och skrivtid, släpper lata källhandtag, lägger till direkt, spolar filen och trunkerar tillbaka till originalängden om tilläggningen misslyckas. Båda vägarna bevarar befintliga byteintervall och tidigare signaturer

 

När inget objekt är smutsigt eller borttaget är målet byte-identiskt med källan, och ingen xref-sektion, trailer, nyrad eller EOF-markör läggs till. När en revision krävs förblir det första trailer-ID:et stabilt och bara det andra ändrings-ID:et roteras

För en krypterad källa upprepar den tilllagda trailern det ursprungliga /Encrypt -objekt- och generationsreferensen exakt. Omskrivna strängar och strömmar forblir skyddade av källans säkerhetshanterare, och det resulterande dokumentet fortsätter att acceptera de ursprungliga Standard-användar- och ägarlösenorden eller autentiseringsuppgifter för mottagare med publik nyckel

En lyckad tilläggning till samma mål konsumerar den hållna källan eftersom originalrevisionen har ändrats på plats. Anropa BeginIncrementalUpdate igen innan ytterligare en revision skapas. GetIncrementalUpdateSourceInfo exponerar behållna byte, sondbyte, kopierings- och tilläggsräknare, spårade ändringar, besökta objekt, xref-poster, låsning och konsumtionstillstånd

Förstörande redigeringar bygger om den completa aktiva fri-objektkedjan automatiskt. Befintliga fri-generationer bevaras, nymfriställda generationer avanceras upp till 65535, omskrivna objekt behåller sina ursprungliga generationer, och varje emitterad post ordnas per objektnummer. GetLastIncrementalXRefRebuildInfo returnerar käll-, övergångs-, mättnads- och ombyggd-kedjeräkningarna efter sparandet

Anropa den här metoden innan du förbereder eller infogar en ny signatur när du lägger till en senare signaturrevision. När den tillagda filen finns använder du de vanliga signeringshjälparna för att reservera och fylla det nya signaturvärdet

För certifierade dokument eller dokument med användningsrättigheter skriver SaveIncrementalUpdateAuthenticated en same-directory-kandidat, autentiserar varje policybärande signatur, tillämpar varje senare revision och ersätter målet atomärt först efter att alla policyer accepterar uppdateringen

 

Se även: BeginIncrementalUpdate, MarkDirty, AcroForm Support, PDF Filter Support