SignFile
אבטחה וחתימות
תיאור
Applies a digital signature to a PDF document on disk.
זהות החתימה חייבת להיות בפורמט 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 | The path and name of the PKCS#12 certificate/private key file (.pfx file). The password to open the PFX file. |
| PFXPassword | מחרוזת אופציונלית המציינת את סיבת החתימה |
| Reason | |
| Location | מחרוזת אופציונלית המציינת את המקום שבו בוצעה החתימה |
| ContactInfo | מחרוזת אופציונלית המציינת את פרטי הקשר של החותם |
ערכי החזרה
| 1 | הקובץ נחתם בהצלחה 2 קובץ ה-PDF הנכנס לא נמצא 3 לא ניתן לקרוא את קובץ ה-PDF הנכנס סיסמת ה-PDF הנכנס שגויה 4 5 קובץ התעודה לא נמצא 6 קובץ התעודה אינו תקין 7 סיסמת התעודה שגויה 8 פורמט תעודה לא מוכר לא נמצא מפתח פרטי בקובץ התעודה 9 10 לא ניתן היה לכתוב את קובץ הפלט 11 לא ניתן היה להחיל את החתימה שם שדה החתימה היה ריק 12 |
|---|