LoadFromMappedFile
Správa dokumentov, výkon, vstup zo súboru
Popis
Načíta a vyberie lokálne PDF cez ohraničené mapované zobrazenie iba na čítanie, takže veľké odložené čítania objektov a streamov môžu znovu použiť súbory strán operačného systému bez uchovania celého zdroja v pamäti
Syntax
Delphi
Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;Parametre
| FileName | Cesta k lokálnemu PDF |
|---|---|
| Password | Heslo na otvorenie PDF alebo prázdny reťazec pre nešifrovaný dokument |
| WindowSize | Požadovaná veľkosť mapovaného zobrazenia v bajtoch; nula vyberá 64 MiB, hodnoty pod granularitou alokácie operačného systému sa zvýšia na tú granularitu a hodnoty nad 1 GiB sa obmedzia |
| Options | Nula pripúšťa náhradu súborového streamu iba na čítanie, kým PDF_MAPPED_FILE_REQUIRE_MAPPING zlyhá, pokiaľ nie je aktívne mapované zobrazenie |
Návratové hodnoty
| 0 | Argumenty boli neplatné, súbor sa nedal otvoriť, požadované mapovanie nebolo dostupné alebo sa PDF nepodarilo načítať; preskúmajte LastErrorCode |
|---|---|
| 1 | Dokument bol načítaný a vybraný |
Poznámky
Buildy Windows uchovávajú jedno zobrazenie iba na čítanie a premapujú ho podľa potreby na hraniciach granularita alokácie; ostatné platformy a zlyhania mapovania používajú rovnakú zmluvu absolútnych čítaní cez obyčajný súborový stream iba na čítanie, pokiaľ nie je mapovanie vyžadovanéPredvolené zobrazenie 64 MiB obmedzuje použitie adresového priestoru nezávisle od veľkosti zdroja a je vhodné pre rozptýlený prístup k veľkým lokálnym súborom; menšie zobrazenie môže znížiť rezidentný adresový priestor na úkor väčšieho počtu premapovaníAbsolútne čítania rezov objektov kopírujú priamo z aktuálneho zobrazenia do úložiska vlastneného analyzátorom bez zmeny pozičného kurzora streamu; nejde o trvalé API ukazovateľov nulovej kópie, pretože premapovanie zneplatní adresy zobrazeníZdroj zostáva otvorený, kým sa načítaný dokument neodstráni, a ukladanie alebo odložená extrakcia môžu z neho naďalej čítaťAk je priradené
OnPassword, každé zamietnuté opakovanie hesla obdrží čerstvý mapovaný stream a stav analyzátoruPomocou
GetMappedFileInfo potvrďte, či je mapovanie aktívne, a preskúmajte aktuálne štatistiky zobrazenia a čítania