SignFileA
Security and Signatures
คำอธิบาย
อักษร A ท้ายชื่อบอกว่าเป็นจุดเรียก DLL แบบ ANSI (char), ส่วน ActiveX/COM เปิดเผยเฉพาะรูปแบบ Unicode พฤติกรรมเหมือน SignFile ทุกอย่าง และอาร์กิวเมนต์สตริงถูกตีความตาม code page ปัจจุบันของ SetAnsiMode
ใช้ลายเซ็นดิจิทัลกับเอกสาร PDF บนดิสก์
ตัวตนการลงลายเซ็นต้องเป็นฟอร์แมต PKCS#12 ที่มีทั้งใบรับรองและ private key
ไวยากรณ์
Delphi
Function DLSignFileA(InstanceID: Integer; InputFileName, OpenPassword, SignatureFieldName, OutputFileName, PFXFileName, PFXPassword, Reason, Location, ContactInfo: PAnsiChar): Integer;
DLL
int DLSignFileA(int InstanceID, const char * InputFileName, const char * OpenPassword, const char * SignatureFieldName, const char * OutputFileName, const char * PFXFileName, const char * PFXPassword, const char * Reason, const char * Location, const char * ContactInfo);
พารามิเตอร์
| InputFileName | พาธและชื่อไฟล์ PDF อินพุตที่จะลงลายเซ็น |
|---|---|
| OpenPassword | รหัสผ่าน (ถ้ามี) สำหรับเปิด PDF อินพุตที่เข้ารหัสไว้ |
| SignatureFieldName | ชื่อฟิลด์ลายเซ็นที่จะลงลายเซ็น ถ้าไม่มีฟิลด์ชื่อนี้อยู่ จะถูกสร้างขึ้น ฟิลด์นี้ห้ามเว้นว่าง |
| OutputFileName | พาธและชื่อไฟล์ PDF ที่ลงลายเซ็นแล้วซึ่งจะสร้างขึ้น ต้องเป็นไฟล์ต่างจาก InputFileName ถ้าต้องการลงลายเซ็นแทนที่ไฟล์เดิม (เขียนทับไฟล์ต้นฉบับ) ให้เว้นพารามิเตอร์นี้ว่าง |
| PFXFileName | พาธและชื่อไฟล์ใบรับรอง/private key PKCS#12 (ไฟล์ .pfx) และรหัสผ่านสำหรับเปิดไฟล์ PFX |
| PFXPassword | สตริง (ไม่บังคับ) บอกเหตุผลการลงลายเซ็น |
| Reason | |
| Location | สตริง (ไม่บังคับ) บอกตำแหน่งที่ทำการลงลายเซ็น |
| ContactInfo | สตริง (ไม่บังคับ) บอกข้อมูลติดต่อของผู้ลงลายเซ็น |
ค่าที่ส่งคืน
| 1 | ลงลายเซ็นไฟล์สำเร็จแล้ว 2 ไม่พบ PDF อินพุต 3 อ่าน PDF อินพุตไม่ได้ รหัสผ่าน PDF อินพุตผิด 4 5 ไม่พบไฟล์ใบรับรอง 6 ไฟล์ใบรับรองไม่ถูกต้อง 7 รหัสผ่านใบรับรองผิด 8 ฟอร์แมตใบรับรองไม่รู้จัก ไม่พบ private key ในไฟล์ใบรับรอง 9 10 เขียนไฟล์เอาต์พุตไม่ได้ 11 ใช้ลายเซ็นไม่สำเร็จ ชื่อฟิลด์ลายเซ็นว่างเปล่า 12 |
|---|