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 | رشتهای اختیاری که اطلاعات تماس امضاکننده را مشخص میکند |
مقادیر بازگشتی
| 1 | فایل با موفقیت امضا شد 2 یافتن PDF ورودی ممکن نبود 3 خواندن PDF ورودی ممکن نبود گذرواژهٔ PDF ورودی نادرست است 4 5 فایل گواهی یافت نشد 6 فایل گواهی نامعتبر است 7 گذرواژهٔ گواهی نادرست است 8 قالب گواهی ناشناخته کلید خصوصی در فایل گواهی یافت نشد 9 10 نوشتن فایل خروجی ممکن نبود 11 اعمال امضا ممکن نبود نام فیلد امضا خالی بود 12 |
|---|