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 要求必须有活动的映射视图 |
返回值
| >0 | Direct Access 文档句柄 |
|---|---|
| 0 | 参数、文件、密码、映射要求或 PDF 结构无效;请检查 LastErrorCode |
备注
返回的句柄拥有已映射的源,传给 DACloseFile 时会释放其视图和文件句柄
保留的窗口会按需为页面、对象和流读取重新映射;所有读取仍受物理文件大小限制
检视该句柄的源与重映射统计信息,请使用 DAGetMappedFileInfo