LoadFromMappedFile
Dokumentumkezelés, teljesítmény, fájlbemenet
Leírás
Helyi PDF-et tölt be és választ ki egy korlátozott, csak olvasható leképezett nézeten keresztül, lehetővé téve, hogy a nagy, halasztott objektum- és adatfolyamolvasások újrahasznosítsák az operációs rendszer fájloldalait anélkül, hogy a teljes forrást memóriában tartaná
Szintaxis
Delphi
Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;Paraméterek
| FileName | A helyi PDF elérési útja |
|---|---|
| Password | A PDF megnyitásához használt jelszó, vagy üres karakterlánc titkosítatlan dokumentum esetén |
| WindowSize | A kért leképezett nézet mérete bájtban; a nulla 64 MiB-t választ, az operációs rendszer foglalási finomsága alatti értékek arra a finomságra emelkednek, az 1 GiB felettiek pedig korlátozódnak |
| Options | A nulla csak olvasható fájl-adatfolyam tartalékot enged, míg a PDF_MAPPED_FILE_REQUIRE_MAPPING meghiúsul, hacsak nincs aktív leképezett nézet |
Visszatérési értékek
| 0 | Az argumentumok érvénytelenek voltak, a fájl nem nyitható meg, a szükséges leképezés nem állt rendelkezésre, vagy a PDF nem tölthető be; vizsgálja meg a LastErrorCode értékét |
|---|---|
| 1 | A dokumentum betöltésre és kijelölésre került |
Megjegyzések
A Windows build egy csak olvasható nézetet tart meg, és igény szerint újraleképezi foglalási-pontossági határokon; más platformok és leképezési hibák ugyanazt az abszolút-olvasási szerződést használják normál csak olvasható fájl-adatfolyamon, hacsak a leképezés nem szükséges
Az alapértelmezett 64 MiB nézet a címtérhasználatot a forrás méretétől függetlenül korlátozza, és ritka hozzáférésre alkalmas nagy helyi fájlokhoz; kisebb nézet a lakócímtért csökkentheti több újraleképezés árán
Az abszolút objektumszelet-olvasások közvetlenül az aktuális nézetből a feldolgozó tulajdonában lévő tárolóba másolnak a pozicionális adatfolyam-kurzor mozgatása nélkül; ez nem tartós zero-copy mutató API, mert az újraleképezés érvényteleníti a nézetcímeket
A forrás nyitva marad, amíg a betöltött dokumentum el nem távolításra kerül, és a mentés vagy halasztott kinyerés folytathatja olvasását
OnPassword hozzá van rendelve, minden elutasított jelszó-újrapróbálkozás friss leképezett adatfolyamot és értelmezőállapotot kapA
GetMappedFileInfo segítségével ellenőrizheti, hogy aktív-e a leképezés, és megvizsgálhatja az aktuális nézet- és olvasási statisztikákat