THotPDF.CopyLoadedSourceToStream

Kopierer de originale indlæste PDF-bytes med en kildepositionsbevarende afgrænset læsning

Declaration

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

Adfærd

Denne HPDFDoc-metode kopierer de tilbageholdte originale kilde-bytes uden at gemme eller normalisere den aktuelle objektgraf og gendanner den lånte kildestream-position ved succes og fejl

Krypterede filindlæsninger bevarer et separat originalt læsehandle, selv efter at adgangskodebaseret dekryptering deaktiverer den almindelige gem-genvej; denne metode kopierer den originale ciphertext, og GetLoadedSourceFileSize rapporterer dens størrelse

Det tilbageholdte originale handle frigøres ved genindlæsning, destruktion og understøttet in-place inkrementel publicering og deltager i fysiske kildefil-alias-tjek

MaxBytes skal være positivt og inkluderer den komplette kildelængde; en større kilde udløser EHPDFIncrementalOutputBudget før den første skrivning

Destination skal være non-nil og må ikke aliasere den indlæste stream eller samme underliggende fil, inklusive et hard link; en utilgængelig original kilde udløser EInvalidOpException

OperationCancellationToken og Checkpoint tjekkes før og under læsninger i blokke på højst 64 KiB; checkpointet modtager THotPDF-instansen

Metoden skriver ved destinationens aktuelle position uden at rydde dens eksisterende indhold; cancellation, læsefejl eller destinationsfejl kan efterlade en delvis kopi, så kaldere bør kassere en mislykket kandidat

Metoden serialiserer ikke ventende objektændringer og etablerer ikke, at den indlæste graf stadig matcher den rå kilde

Relaterede emner

Incremental PFX signing, THotPDF.SaveIncrementalUpdate