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

Related topics

Incrementele PFX signing, THotPDF.SaveIncrementalUpdate