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 لفحص إحصاءات المصدر وإعادة التعيين للمقبض