THotPDF.CopyLoadedSourceToStream

Kopierar de ursprungliga laddade PDF-bytes med en avgränsad läsning som bevarar källpositionen

Deklaration

procedure CopyLoadedSourceToStream(Destination: TStream;
  MaxBytes: Int64; Checkpoint: TNotifyEvent = nil);

Beteende

Denna HPDFDoc-metod kopierar de behållna ursprungliga källbytena utan att spara eller normalisera den aktuella objektgrafen, och återställer den lånade källströmmens position vid både framgång och misslyckande

Laddningar av krypterade filer behåller ett separat ursprungligt läs-handtag även efter att lösenordsbaserad dekryptering inaktiverar den ordinarie spargenvägen; denna metod kopierar den ursprungliga chiffertexten och GetLoadedSourceFileSize rapporterar dess storlek

Det behållna ursprungliga handtaget frigörs vid omladdning, förstörelse och stödd inkrementell publicering på plats, och deltar i kontroller av fysiska källfilsalias

MaxBytes måste vara positivt och inkluderar hela källängden; en större källa kastar EHPDFIncrementalOutputBudget före den första skrivningen

Destination måste vara icke-nil och får inte vara ett alias för den laddade strömmen eller samma underliggande fil, inklusive en hård länk; en otillgänglig ursprungskälla kastar EInvalidOpException

OperationCancellationToken och Checkpoint kontrolleras före och under läsningar i block på högst 64 KiB; checkpointen tar emot THotPDF-instansen

Metoden skriver vid destinationens aktuella position utan att rensa dess befintliga innehåll; avbrott, läsfel eller destinationsfel kan lämna en partiell kopia, så anropare bör kasta en misslyckad kandidat

Metoden serialiserar inte väntande objektändringar och fastställer inte att den laddade grafen fortfarande matchar råkällan

Relaterade ämnen

Inkrementell PFX-signering, THotPDF.SaveIncrementalUpdate