LoadFromMappedFile
مدیریت سند، کارایی، ورودی فایل
توضیحات
یک PDF محلی را از طریق نمای نگاشتشده فقطخواندنی محدودشده بارگذاری و انتخاب میکند و به خواندنهای بزرگ بهتعویقافتاده شیء و جریان اجازه میدهد صفحات فایل سیستمعامل را دوباره به کار گیرند، بدون نگهداشتن کامل مبدأ در حافظه
نحو
Delphi
Function TPDFlib.LoadFromMappedFile(Const FileName, Password: WideString;
WindowSize: Int64= 0; Options: Integer= 0): Integer;پارامترها
| FileName | مسیر PDF محلی |
|---|---|
| Password | گذرواژه بازکردن PDF، یا رشته خالی برای سند رمزنشده |
| WindowSize | اندازه درخواستی نمای نگاشتشده بر حسب بایت؛ صفر 64 MiB را برمیگزیند، مقادیر زیر دانهبندی تخصیص سیستمعامل به همان دانهبندی بالا برده میشوند و مقادیر بالای 1 GiB محدود میشوند |
| Options | صفر جایگزین جریان فایل فقطخواندنی را مجاز میکند، در حالی که PDF_MAPPED_FILE_REQUIRE_MAPPING شکست میخورد مگر آنکه نمای نگاشتشده فعالی باشد |
مقادیر بازگشتی
| 0 | آرگومانها نامعتبر بودند، فایل باز نشد، نگاشت الزامی در دسترس نبود یا PDF قابل بارگذاری نبود؛ LastErrorCode را بررسی کنید |
|---|---|
| 1 | سند بارگذاری و انتخاب شد |
توضیحات
ساختهای Windows یک نمای فقطخواندنی نگه میدارند و در صورت نیاز در مرزهای دانهبندی تخصیص دوباره نگاشتش میکنند؛ سایر پلتفرمها و شکستهای نگاشت، مگر آنکه نگاشت الزامی باشد، همان قرارداد خواندن مطلق را روی یک جریان فایل عادی فقطخواندنی به کار میبرندنمای پیشفرض 64 MiB مصرف فضای آدرس را مستقل از اندازه مبدأ محدود میکند و برای دسترسی پراکنده به فایلهای محلی بزرگ مناسب است؛ نمای کوچکتر میتواند فضای آدرس مقیم را به قیمت نگاشتهای مجدد بیشتر کاهش دهدخواندنهای مطلق برش شیء، مستقیماً از نمای جاری در حافظه متعلق به تجزیهگر کپی میکنند، بیآنکه نشانگر مکانی جریان عوض شود؛ این یک API اشارهگر پایدار بدونکپی نیست، چون نگاشت مجدد آدرسهای نما را نامعتبر میکندمبدأ تا زمانی که سند بارگذاریشده حذف شود باز میماند و ذخیره یا استخراج بهتعویقافتاده میتواند به خواندن آن ادامه دهداگر
OnPassword منتسب شده باشد، هر تلاش مجدد گذرواژه ردشده یک جریان نگاشتشده تازه و وضعیت تجزیهگر دریافت میکندبرای تأیید فعالبودن نگاشت و بررسی آمار جاری نما و خواندنها از
GetMappedFileInfo استفاده کنید