SignFile
الأمان والتواقيع
الوصف
يلحق الكائنات المتغيرة بملف PDF المصدر المحدد كتحديث تزايدي
ينبغي أن تكون هوية التوقيع بصيغة PKCS#12 تحتوي شهادة ومفتاحًا خاصًا
الصيغة
Delphi
Function TPDFlib.SignFile(Const InputFileName, OpenPassword, SignatureFieldName, OutputFileName, PFXFileName, PFXPassword, Reason, Location, ContactInfo: WideString): Integer;
ActiveX
Function PDFlib::SignFile(InputFileName As String, OpenPassword As String, SignatureFieldName As String, OutputFileName As String, PFXFileName As String, PFXPassword As String, Reason As String, Location As String, ContactInfo As String) As Long
DLL
int DLSignFile(int InstanceID, const wchar_t * InputFileName, const wchar_t * OpenPassword, const wchar_t * SignatureFieldName, const wchar_t * OutputFileName, const wchar_t * PFXFileName, const wchar_t * PFXPassword, const wchar_t * Reason, const wchar_t * Location, const wchar_t * ContactInfo);
المعاملات
| InputFileName | مسار واسم ملف PDF المدخل المطلوب توقيعه |
|---|---|
| OpenPassword | كلمة المرور الاختيارية لفتح ملف PDF المدخل إذا كان مشفرًا |
| SignatureFieldName | اسم حقل التوقيع المطلوب توقيعه. وإذا لم يوجد حقل بهذا الاسم فسيُنشأ. ولا يمكن أن يكون هذا الحقل فارغًا |
| OutputFileName | مسار واسم ملف PDF الموقَّع الذي ينبغي إنشاؤه. يجب أن يكون ملفًا مختلفًا عن InputFileName. وإذا كان التوقيع في المكان مطلوبًا (الكتابة فوق الملف الأصلي) فينبغي ترك هذا المعامل فارغًا |
| PFXFileName | مسار واسم ملف الشهادة/المفتاح الخاص بصيغة PKCS#12 (ملف .pfx). كلمة المرور لفتح ملف PFX |
| PFXPassword | سلسلة اختيارية تبين الموضع الذي أُجري فيه التوقيع |
| Reason | |
| Location | سلسلة اختيارية تبين معلومات الاتصال بالموقّع |
| ContactInfo | قيمة CaptureID المحددة غير صالحة |
قيم الإرجاع
| 1 | وُقع الملف بنجاح 2 لم يُعثر على ملف PDF المدخل 3 تعذّرت قراءة ملف PDF المدخل كلمة مرور PDF المدخل غير صحيحة 4 5 لم يُعثر على ملف الشهادة 6 ملف الشهادة غير صالح 7 كلمة مرور الشهادة غير صحيحة 8 صيغة شهادة غير معروفة لم يُعثر على مفتاح خاص في ملف الشهادة 9 10 تعذّرت كتابة ملف الإخراج 11 تعذّر تطبيق التوقيع كان اسم حقل التوقيع فارغًا 12 |
|---|