DAOpenMappedFile

إدارة المستندات، وظائف الوصول المباشر، الأداء

الوصف

يفتح PDF محليًا لـ Direct Access عبر عرض معيَّن محدود للقراءة فقط دون احتجاز الملف كاملًا في الذاكرة

الصيغة

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مقبض مستند Direct Access
0الوسائط أو الملف أو كلمة المرور أو اشتراط التعيين أو بنية PDF غير صالحة؛ افحص LastErrorCode

ملاحظات

يمتلك المقبض المعاد المصدر المعين ويحرر عرضه ومقابض ملفه عند تمريره إلى DACloseFile

يعاد إسناد النافذة المحتجزة عند الطلب لقراءات الصفحات والكائنات والتدفقات؛ وتبقى كل القراءات محودة بالحجم الفيزيائي للملف

DAGetMappedFileInfo لفحص إحصاءات المصدر وإعادة التعيين للمقبض