DAAppendFile

مدیریت سند، قابلیت دسترسی مستقیم

توضیحات

تغییرات اعمال‌شده به سندی که در اصل با تابع DAOpenFile باز شده را الصاق می‌کند؛ این عملیات سریع است چون فقط اشیاء تغییرکرده باید به انتهای فایل اصلی اضافه شوند. فایل پس از این عملیات بسته می‌شود و هندل فایل دیگر معتبر نخواهد بود

این تابع وقتی کار نمی‌کند که فایل مبدأ در حالت فقط‌خواندنی باز شده باشد یا سند از فایلی بدشکل بارگذاری شده باشد، مثلاً جایی که فاصلهٔ خالی به ابتدای فایل اضافه شده است. در این موارد به‌جای آن باید از تابع DASaveAsFile استفاده کرد

نحو

Delphi

Function TPDFlib.DAAppendFile(FileHandle: Integer): Integer;

ActiveX

Function PDFlib::DAAppendFile(FileHandle As Long) As Long

DLL

int DLDAAppendFile(int InstanceID, int FileHandle);

پارامترها

FileHandleهندلی که توسط توابع DAOpenFile، DAOpenFileReadOnly یا DAOpenFromStream بازگردانده می‌شود

مقادیر بازگشتی

0FileHandle مشخص‌شده معتبر نبود؛ تغییرات فایل با موفقیت append شدند
12 فایل در حالت فقط‌خواندنی باز شده و به‌روزرسانی قابل نوشتن نیست؛ به‌جای آن از DASaveAsFile استفاده کنید 3 سند از فایلی بدشکل باز شده و عملیات الصاق ممکن نیست؛ به تابع DAShiftedHeader نگاه کنید