THotPDF.PrepareLoadedFormDataRevisionToStream

Förbereder en privat revision av den faktiskt inlästa grafen utan att ändra det ursprungliga dokumentet

Deklaration

procedure PrepareLoadedFormDataRevisionToStream(Destination: TStream;
  const Password: AnsiString; MaxWorkingBytes, MaxOutputBytes: Int64;
  MaxObjects: Integer; Checkpoint: TNotifyEvent = nil;
  OriginalSource: TStream = nil);

Beteende

Metoden kopierar ursprunglig revision till en exklusivt skapad privat fil, läser in ett separat inkrementellt dokument, jämför semantiska objektgrafer per objektnummer och generation, klonar faktiska väntande ändringar och skriver den resulterande kandidaten vid aktuell destinationsposition

Textvärden, befintliga utseenden, orelaterade väntande katalogändringar, indirekta referenser, ströminnehåll och nya grafobjekt deltar i förberedelsen; PDF-namn avkodas en gång och dubbletterade semantiska ordlistnamn är ogiltiga

En oförändrad graf kopierar de exakta ursprungliga bytena utan att lägga till en tom inkrementell korsreferenssektion; ändrade grafer behåller det completa ursprungliga byteprefixet och lägger till sin aktuella revision

Krypterade revisioner behåller sin ursprungliga krypteringsordlista och nyckel; Password måste autentisera ursprunglig revision och tillhandahålls som UTF-8-byte

OriginalSource, när tillhandahållen, måste vara den completa oföränderliga ursprungliga revisionen som detta dokument lästes in ur, inklusive chiffertext och signerade byte; dess position återställs vid framgång och fel

Utan OriginalSource använder metoden CopyLoadedSourceToStream; det gör inte en externt muterbar lånad källa till en oföränderlig ögonblicksbild, så anropare måste bevara dess exakta inlästa byte

MaxWorkingBytes måste vara minst 1 MiB; MaxOutputBytes och MaxObjects måste vara positiva; källkopiering, objektjämförelse, residenta och spillda klondatar samt utdatalängd har ändliga gränser

OperationCancellationToken och Checkpoint polleras under kopiering och jämförelse; kopiering använder block högst 64 KiB; en misslyckad förberedelse kan lämna partiella destinationsbyte, som anroparen måste kassera

Denna lågnivåmetod förbereder en grafrevision och auktoriserar inte väntande ändringar under DocMDP eller FieldMDP; använd THPDFWindowsFormDataTransaction för att autentisera signaturpolicy innan formuläruppdateringar publiceras

Den ursprungliga THotPDF-grafen, källägarskap, väntande ändringar och inställningar förblir intakta när förberedelsen lyckas eller misslyckas; temporära filer stängs och tas bort när metoden avslutas

Relaterade ämnen

CopyLoadedSourceToStream, THPDFWindowsFormDataTransaction, Windows FDF/XFDF-utbyte