DASaveAsFileA
مدیریت سند، قابلیت دسترسی مستقیم
توضیحات
حرف A در انتهای نام، entry point مربوط به DLL از نوع ANSI (char) را نشان میدهد؛ سطح ActiveX/COM فقط فرم Unicode را ارائه میکند. رفتار با DASaveAsFile یکسان است و آرگومانهای رشتهای با استفاده از code page فعلی SetAnsiMode تفسیر میشوند
کل فایل شامل همهٔ تغییرات را در فایل جدیدی بازنویسی میکند؛ این عملیات برای فایلهای بزرگ یا فایلهای با اشیاء زیاد ممکن است زمانبر باشد. هدر خروجی از نسخهٔ مؤثر سند DA استفاده میکند، از جمله هر بالابری نسخهای که ویرایشهای Direct Access ایجاد کرده باشند. فایل اصلی پس از این عملیات بسته میشود و هندل فایل دیگر معتبر نخواهد بود. فایل اصلی قابل بازنویسی نیست؛ اگر میخواهید تغییرات را به فایل اصلی الصاق کنید از DAAppendFile استفاده کنید
نحو
Delphi
Function DLDASaveAsFileA(InstanceID, FileHandle: Integer; OutputFileName: PAnsiChar): Integer;
DLL
int DLDASaveAsFileA(int InstanceID, int FileHandle, const char * OutputFileName);
پارامترها
| FileHandle | هندلی که توسط توابع DAOpenFile، DAOpenFileReadOnly یا DAOpenFromStream بازگردانده میشود |
|---|---|
| OutputFileName | مسیر و نام سند جدید برای ساختن |
مقادیر بازگشتی
| 0 | فایل جدید ساخته نشد |
|---|---|
| 1 | سند با موفقیت در فایل جدید ذخیره شد |