DAOpenMappedFile

文档管理、直接访问功能、性能

描述

通过有边界的只读映射视图打开本地 PDF 以进行 Direct Access,而不会把完整文件保留在内存中

语法

Delphi

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

参数

InputFileName本地 PDF 的路径
Password文档密码;PDF 未加密时为空字符串
WindowSize请求的映射视图大小(字节);为 0 时选择 64 MiB,实际生效值会对齐并上限为 1 GiB
Options为 0 时允许回退到只读文件流;PDF_MAPPED_FILE_REQUIRE_MAPPING 要求必须有活动的映射视图

返回值

>0Direct Access 文档句柄
0参数、文件、密码、映射要求或 PDF 结构无效;请检查 LastErrorCode

备注

返回的句柄拥有已映射的源,传给 DACloseFile 时会释放其视图和文件句柄

保留的窗口会按需为页面、对象和流读取重新映射;所有读取仍受物理文件大小限制

检视该句柄的源与重映射统计信息,请使用 DAGetMappedFileInfo