THotPDF.CopyLoadedSourceToStream
Kopieert de originele geladen PDF-bytes met een bronpositie-behoudende begrensde read
Declaration
procedure CopyLoadedSourceToStream(Destination: TStream;
MaxBytes: Int64; Checkpoint: TNotifyEvent = nil);
Behavior
Deze HPDFDoc-methode kopieert de vastgehouden originele bronbytes zonder de huidige objectgraaf op te slaan of te normaliseren, en herstelt de positie van de geleende bronstream bij succes en falen
Versleutelde bestandsloads houden een apart origineel read-handle vast, zelfs nadat op wachtwoord gebaseerde decryptie de gewone save-shortcut uitschakelt; deze methode kopieert de originele ciphertext en GetLoadedSourceFileSize rapporteert diens grootte
Het vastgehouden originele handle wordt vrijgegeven tijdens herladen, destructie en ondersteunde in-place incrementele publicatie, en doet mee aan fysieke bronbestand-alias-checks
MaxBytes moet positief zijn en omvat de complete bronlengte; een grotere bron raiset EHPDFIncrementalOutputBudget vóór de eerste write
Destination moet niet-nil zijn en mag niet aliasen met de geladen stream of hetzelfde onderliggende bestand, inclusief een hard link; een onbeschikbare originele bron raiset EInvalidOpException
OperationCancellationToken en Checkpoint worden gecheckt vóór en tijdens reads in blokken van hoogstens 64 KiB; het checkpoint ontvangt de THotPDF-instantie
De methode schrijft op de huidige positie van de destination zonder diens bestaande inhoud te wissen; annulering, leesfouten of destination-falen kunnen een partiele kopie achterlaten, dus aanroepers doen er goed aan een mislukte candidate weg te gooien
De methode serialiseert geen pending objectwijzigingen en bewijst niet dat de geladen graaf nog matcht met de raw bron