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