LoadFromMappedFile
Documentbeheer, prestaties, bestandsinvoer
Beschrijving
Laadt en selecteert een lokale PDF via een begrensde, alleen-lezen mapped view, waardoor grote uitgestelde object- en streamlezingen bestandspagina's van het besturingssysteem kunnen hergebruiken zonder de volledige bron in het geheugen vast te houden
Syntaxis
Delphi
Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;Parameters
| FileName | Het pad van de lokale PDF |
|---|---|
| Password | Het wachtwoord waarmee de PDF wordt geopend, of een lege string voor een niet-versleuteld document |
| WindowSize | De gevraagde mapped-view size in bytes; nul kiest 64 MiB, waarden onder de toewijzingsgranulariteit van het besturingssysteem worden verhoogd naar die granulariteit en waarden boven 1 GiB worden begrensd |
| Options | Nul staat een alleen-lezen bestandsstream-terugval toe, terwijl PDF_MAPPED_FILE_REQUIRE_MAPPING faalt tenzij een mapped view actief is |
Retourwaarden
| 0 | De argumenten waren ongeldig, het bestand kon niet worden geopend, vereiste mapping was niet beschikbaar of de PDF kon niet worden geladen; raadpleeg LastErrorCode |
|---|---|
| 1 | Het document is geladen en geselecteerd |
Opmerkingen
Windows-builds houden één alleen-lezen view vast en wijzen die op aanvraag op grenzen van allocatiegranulariteit opnieuw toe; andere platformen en toewijzingsfalen gebruiken hetzelfde absolute leescontract over een gewone alleen-lezen bestandsstream tenzij toewijzing vereist is
De standaardview van 64 MiB begrenst adresruimtegebruik onafhankelijk van brongrootte en is geschikt voor schaarse toegang tot grote lokale bestanden; een kleinere view kan residente adresruimte verminderen ten koste van meer her-toewijzingen
Absolute objectsegmentlezingen kopieren rechtstreeks vanuit de huidige view naar opslag in eigendom van de parser zonder de positionele streamcursor te wijzigen; dit is geen persistente zero-copy-pointer-API omdat her-toewijzing viewadressen ongeldig maakt
De bron blijft open totdat het geladen document wordt verwijderd, en opslaan of uitgestelde extractie kan er nog uit lezen
OnPassword is toegewezen, ontvangt elke geweigerde wachtwoordpoging een verse mapped stream en parsertoestandGebruik
GetMappedFileInfo om te bevestigen of mapping actief is en de huidige view- en leesstatistieken te bekijken