DAOpenFromURL

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

الوصف

يفتح PDF بعيدًا عبر HTTP للوصول المباشر باستخدام طلبات مدايات بايتية

يفحص النقل الـ URL مرة واحدة لتأكيد دعم مدايات البايتات ومعرفة الطول الكلي ثم يقود تدفق قابل للتمرير قارئ الوصول العشوائي القائم فيجلب عبر الشبكة الكائنات المقروءة فعليًا فقط

عندما يكون المستند مجزأً خطيًا وتمكين تسخين الذاكرة يجلب قسم الصفحة الأولى مسبقًا ضمن ميزانية البايتات المحتجزة فرسم الصفحة 1 قبل لمس بقية الملف

الصيغة

Delphi

Function TPDFlib.DAOpenFromURL(Const URL, Password: WideString; Options: Integer= 0; ChunkSize: LongInt= 0; CacheLimitBytes: Int64= 0; CoalesceWindowMS: Cardinal= PDF_NET_DEFAULT_COALESCE_WINDOW_MS): Integer;

DLL

int DLDAOpenFromURL(int InstanceID, const wchar_t* URL, const wchar_t* Password, int Options);

ActiveX

Function PDFlib::DAOpenFromURL(URL As String, Password As String, Options As Long) As Long

المعاملات

URLعنوان http أو https لملف PDF البعيد
Passwordكلمة مرور المستند، أو سلسلة فارغة عندما لا يكون PDF مشفرًا
Optionsالصفر للفتح الافتراضي مع تسخين الصفحة الأولى، أو PDF_NET_OPT_NO_WARMING للفتح عند الطلب بحتًا
ChunkSizeفي Delphi فقط؛ حبيبية جلب النطاقات المحاذاة، والصفر يختار 64 KiB
CacheLimitBytesفي Delphi فقط؛ الحد الأقصى للبايتات المصدرية المحتجزة، والصفر يختار 4 MiB وتُرفع القيم دون مقطع واحد إلى مقطع واحد
CoalesceWindowMSفي Delphi فقط؛ نافذة التجميع لأول مقطع غير مخزَّن من كل قراءة مطلقة، والافتراض ملّي ثانيتان والصفر يعطل التأخير الأولي

القيم المُرجعة

>0مقبض مستند Direct Access
0تعذر فتح المستند؛ تُضبط LastErrorCode على PDFLIB_ERROR_NET_OPEN أو PDFLIB_ERROR_NET_RANGE_UNSUPPORTED أو PDFLIB_ERROR_NET_HTTP أو رمز بنية أو كلمة مرور

ملاحظات

يجب أن يعلن الخادم دعمه لنطاقات البايتات؛ وإلا فشل النداء سريعًا بـ PDFLIB_ERROR_NET_RANGE_UNSUPPORTED بدل تنزيل الملف كاملًاأغلق المقبض المُرجع بـ

أغلق المقبض المعاد عبر DACloseFile الذي يحرر أيضًا تدفق النقل الأساسي "underlying" — عربيها: الأساسي. 'الذي يحرر أيضًا تدفق النقل الأساسي'

تتشارك القراءات المؤجلة المتزامنة طلبات الكتلة نفسها وتدمج الكتل المتجاورة المنتظرة في قراءات مصدر محددة بـ 16 ميجابايت

GetLinearizedURLAccessPlan

DAGetRangeSourceCacheInfo لفحص تخطيط نطاقات البايتات للصفحة 1 دون فتح المستنداستخدم DASetRangeSourceCacheLimit وDAClearRangeSourceCache و