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