SetCustomInformationA

خصائص المستند

الوصف

تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ SetCustomInformation وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية

تُستخدم هذه الدالة لتخزين بيانات وصفية مخصصة في المستند. ويمكن قراءة هذه القيم لاحقًا من المستند بالدالة GetCustomInformation. وتُخزن البيانات في قاموس معلومات المستند. أما المحتوى الخاص أو المعلومات البنيوية فينبغي تخزينه في كتالوج المستند باستخدام الدالة SetCatalogInformation

الصيغة

Delphi

Function DLSetCustomInformationA(InstanceID: Integer; Key, NewValue: PAnsiChar): Integer;

DLL

int DLSetCustomInformationA(int InstanceID, const char * Key, const char * NewValue);

المعاملات

Keyيحدد المفتاح المطلوب ضبطه
NewValueالقيمة التي سيُضبط بها المفتاح

قيم الإرجاع

0تعذّر ضبط القيمة. لا يمكن أن يكون المعامل Key هو "Producer" أو "Creator" أو "Subject" أو "Title" أو "Keywords" أو "Author". لهذه المفاتيح استخدم الدالة SetInformation
1تم ضبط قيمة المفتاح بنجاح