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 | تم ضبط قيمة المفتاح بنجاح |