LoadFromMappedFile

Dokumenthantering, prestanda, filindata

Beskrivning

Läser in och väljer en lokal PDF genom en begränsad skrivskyddad mappad vy, vilket låter stora uppskjutna objekt- och strömläsningar återanvända operativsystemets filsidor utan att behålla hela källan i minnet

Syntax

Delphi

Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
  WindowSize: Int64= 0; Options: Integer= 0): Integer;

Parametrar

FileName	Sökvägen till den lokala PDF-filen
Password	Lösenordet som används för att öppna PDF:en, eller en tom sträng för ett okrypterat dokument
WindowSize	Den begärda storleken på mappad vy i byte; noll väljer 64 MiB, värden under operativsystemets allokeringsgranularitet höjs till den granulariteten och värden över 1 GiB begränsas
Options	Noll tillåter en skrivskyddad reservväg via filström, medan `PDF_MAPPED_FILE_REQUIRE_MAPPING` misslyckas om inte en mappad vy är aktiv

Returvärden

0	Argumenten var ogiltiga, filen kunde inte öppnas, krävd mappning var otillgänglig eller PDF:en kunde inte läsas in; granska `LastErrorCode`
1	Dokumentet lästes in och valdes

Anmärkningar

Windowsbyggen behåller en skrivskyddad vy och mappar om den på begäran vid allokeringsgranularitetsgränser; andra plattformar och mappningsfel använder samma kontrakt för absolut läsning över en vanlig skrivskyddad filström om inte mappning krävsStandardvyn på 64 MiB begränsar adressrymdsanvändningen oberoende av källstorlek och passar gles åtkomst till stora lokala filer; en mindre vy kan minska kvarhållen adressrymd till kostnaden för fler ommappningarAbsoluta läsningar av objektsegment kopierar direkt från den aktuella vyn till tolkarägd lagring utan att ändra den positionella strömmarkören; detta är inte ett beständigt zero-copy-pekare-API eftersom ommappning ogiltigförklarar vyadresserKällan förblir öppen tills det inlästa dokumentet tas bort, och sparande eller uppskjuten extraktion kan fortsätta läsa denOm

OnPassword är tilldelad får varje avvisat lösenordsförsök en färsk mappad ström och tolkartillståndAnvänd

GetMappedFileInfo för att bekräfta om mappning är aktiv och granska aktuell vy- och lässtatistik