SetSignProcessExternalDigestSigner
ความปลอดภัยและลายเซ็น
คำอธิบาย
ผูกใบรับรอง X.509 เข้ารหัส DER กับรูปแบบการลงลายเซ็น digest ภายนอก เข้ากับกระบวนการลงลายเซ็น PDF
ไลบรารีประกอบวัตถุ CMS แบบ detached แล้วส่งเฉพาะ digest สุดท้ายของแอตทริบิวต์ authenticated ของมันให้ callback ที่ลงทะเบียนไว้
ไวยากรณ์
Delphi
Function TPDFlib.SetSignProcessExternalDigestSigner(SignProcessID: Integer; Const CertificateDER: AnsiString; SignatureAlgorithm, SignatureReserveBytes: Integer): Integer;
ActiveX
Function PDFlib::SetSignProcessExternalDigestSigner(SignProcessID As Long, CertificateDER As Variant, SignatureAlgorithm As Long, SignatureReserveBytes As Long) As Long
DLL
int DLSetSignProcessExternalDigestSigner(int InstanceID, int SignProcessID, const char* CertificateDER, int CertificateLength, int SignatureAlgorithm, int SignatureReserveBytes);
พารามิเตอร์
| SignProcessID | Value returned by a NewSignProcessFrom* function |
|---|---|
| CertificateDER | ใบรับรอง X.509 เข้ารหัส DER แบบ RSA หรือ ECDSA ทั้งชุดที่คู่กับ private key ภายนอก |
| SignatureAlgorithm | 1 for RSA PKCS#1 v1.5, 2 for DER-encoded ECDSA, or 3 for ECDSA P1363 r || s |
| SignatureReserveBytes | ขอบบนที่คาดไว้ของลายเซ็นดิบ หรือ 0 เพื่ออนุมานจากคีย์สาธารณะของใบรับรอง |
ค่าที่ส่งกลับ
| 1 | ผูกการตั้งค่าตัวตนภายนอกแล้ว |
|---|---|
| 0 | process id, ใบรับรอง, อัลกอริทึม หรือขนาดสำรองไม่ถูกต้อง |
หมายเหตุ
กำหนด OnExternalDigestSign, เรียก DLSetExternalDigestSignCallback หรือให้วัตถุ callback ActiveX พร้อม SetExternalDigestSignCallback ก่อนจบกระบวนการ sign callback ไม่ถูกเรียกระหว่างการวัดขนาดของ
/Contents
CertificateDER
placeholder adbe.pkcs7.sha1 และถูกเรียกเพียงครั้งเดียวสำหรับลายเซ็นสุดท้าย ไบต์ลายเซ็นที่คืนถูกตรวจเทียบกับ adbe.pkcs7.detached ก่อน PDF จะถูกยอมรับเมื่อกระบวนการยังใช้
ดูเพิ่มเติม
OnExternalDigestSign, SetExternalDigestSignCallback, SetSignProcessContentsEstimate, SetSignProcessExternalDigestSignerFromFile