DASetInformationA
ویژگیهای سند، قابلیت دسترسی مستقیم
توضیحات
A پایانی نشاندهنده entry point مربوط به DLL از نوع ANSI (char) است؛ سطح ActiveX/COM فقط فرم Unicode را ارائه میکند. رفتار با DASetInformation یکسان است و آرگومانهای رشتهای با استفاده از code page فعلی SetAnsiMode تفسیر میشوند
مقادیری را در بخش اطلاعات سند تنظیم میکند
این اطلاعات میتوانند اطلاعات استانداردی مانند Author و Subject یا اطلاعات سفارشی باشند
برای CreationDate و ModDate (تاریخ اصلاح)، قالب تاریخ باید اینگونه باشد: D:YYYYMMDDHHmmSSOHH'mm'
where
YYYY سال است
MM ماه است (01-12)، DD روز است (01-31) و HH ساعت است (00-23)
mm دقیقه است (00-59) و SS ثانیه است (00-59)
O رابطهٔ زمان محلی با زمان جهانی (UT) را با یکی از نویسههای +، - یا Z نشان میدهد
HH و بهدنبال آن APOSTROPHE (U+0027) (') باید قدرمطلق اختلاف با UT بر حسب ساعت باشد (00-23)
mm و پس از آن یک APOSTROPHE اختیاری (U+0027) (') باید قدرمطلق اختلاف با UT بر حسب دقیقه باشد (00-59)
نحو
Delphi
Function DLDASetInformationA(InstanceID, FileHandle: Integer; Key, NewValue: PAnsiChar): Integer;
DLL
int DLDASetInformationA(int InstanceID, int FileHandle, const char * Key, const char * NewValue);
پارامترها
| FileHandle | هندلی که توسط توابع DAOpenFile، DAOpenFileReadOnly یا DAOpenFromStream بازگردانده میشود |
|---|---|
| Key | برای اطلاعات استاندارد از "Author"، "Title"، "Subject"، "Keywords"، "Creator"، "Producer"، "CreationDate" یا "ModDate" استفاده کنید. برای اطلاعات سفارشی میتوان از هر رشته دیگری استفاده کرد |
| NewValue | مقدار جدید برای کلید مشخصشده |
مقادیر بازگشتی
| 0 | مقدار FileHandle مشخصشده معتبر نبود کلید اطلاعات با موفقیت تنظیم یا بهروزرسانی شد |
|---|---|
| 1 |