DAOpenMappedFile
文件管理、直接存取功能、效能
描述
透過有界限的唯讀映射檢視開啟本機 PDF 進行直接存取,無須將完整檔案保留在記憶體中
語法
Delphi
Function TPDFlib.DAOpenMappedFile(Const InputFileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;參數
| InputFileName | 本機 PDF 的路徑 |
|---|---|
| Password | 文件密碼;PDF 未加密時為空字串 |
| WindowSize | 要求的映射檢視大小(位元組);零表示選用 64 MiB,實際值會對齊並以 1 GiB 為上限 |
| Options | 零允許回退到唯讀檔案串流;PDF_MAPPED_FILE_REQUIRE_MAPPING 則要求必須有作用中的映射檢視 |
傳回值
| >0 | 直接存取文件控制代碼 |
|---|---|
| 0 | 引數、檔案、密碼、映射要求或 PDF 結構無效;請檢查 LastErrorCode |
備註
傳回的控制碼擁有映射來源,傳給 DACloseFile 時會釋放其視圖與檔案控制碼
保留的視窗會依頁面、物件與串流讀取需求重新映射;所有讀取仍受限於實體檔案大小
請用 DAGetMappedFileInfo 檢視該控制碼的來源與重映射統計