AnalyzeSignatureRevisions - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

สร้างลูกโซ่รีวิชัน incremental ต้นฉบับขึ้นมาใหม่ และจำแนกการเปลี่ยนแปลงที่เกิดขึ้นหลังลายเซ็นที่ฝังอยู่แต่ละรายการ

Syntax

function AnalyzeSignatureRevisions: TPadesRevisionAnalysisReport;

Description

อ่านไบต์ต้นฉบับที่โหลดเข้ามาจริง ตามตาราง xref แบบคลาสสิก, xref stream, hybrid reference และลิงก์ /Prev จากนั้นจับคู่ ByteRange ของลายเซ็นทุกรายการเข้ากับรีวิชันฉบับเต็มที่ลายเซ็นครอบคลุม

อ็อบเจกต์ authoritative ที่ตามมาภายหลังจะถูกจำแนกเป็นลายเซ็น ข้อมูลตรวจสอบความถูกต้อง ฟิลด์ฟอร์ม คำอธิบายประกอบ เนื้อหาหน้า โครงสร้างเอกสาร เมทาดาทา active content อ็อบเจกต์ที่ถูกลบ อ็อบเจกต์บีบอัด หรือการเปลี่ยนแปลงที่ไม่รู้จัก ก่อนประเมินนโยบาย DocMDP และ FieldMDP ที่ใช้บังคับอยู่

นิยามอ็อบเจกต์ที่ปรากฏในไบต์ของรีวิชันแต่ไม่ปรากฏใน xref authoritative จะถูกส่งกลับเป็นการเปลี่ยนแปลงเงาที่น่าสงสัย แทนที่จะถูกละเลยไปโดยเงียบ

Result

TPadesRevisionAnalysisReport คืนค่าสถานะแหล่งที่มา สถานะรวมและความเสี่ยง จำนวนรีวิชันและลายเซ็น ข้อความแสดงข้อผิดพลาด และเรคคอร์ด TPadesSignatureRevisionAnalysis หนึ่งรายการต่อลายเซ็น

เรคคอร์ดลายเซ็นแต่ละรายการประกอบด้วยความยาวและรีวิชันที่ครอบคลุม สิทธิ์ DocMDP การกระทำ FieldMDP และชื่อฟิลด์ จำนวนรีวิชันที่ตามมา ความเสี่ยง สถานะ และการเปลี่ยนแปลงระดับอ็อบเจกต์

Remarks

ต้องให้ Active เป็น True
ผลลัพธ์อธิบายเวอร์ชันต้นฉบับที่โหลดเข้ามา ไม่ใช่การแก้ไขที่ยังไม่ได้บันทึกซึ่งคอมโพเนนต์ถืออยู่ในปัจจุบัน
SourceStatus เป็น pvssOriginalBytes สำหรับไฟล์ที่ยังเก็บไว้ บัฟเฟอร์หน่วยความจำ สตรีมแบบกำหนดเอง หรือแหล่ง progressive ที่โหลดเสร็จสมบูรณ์
แหล่ง progressive ที่ยังโหลดไม่ครบจะคืนค่า pvssIncomplete และ prasIndeterminate
การอัปเดตแคตตาล็อกที่เป็นเพียงข้อมูลตรวจสอบความถูกต้องจะถูกจดจำ โดยไม่ถือว่าการเปลี่ยนแปลงแคตตาล็อกที่ไม่เกี่ยวข้องเป็นสิ่งที่ปลอดภัย
รายการ xref ชนิด type-2 ที่เปลี่ยนแปลงจะรายงานหมายเลขและดัชนี object stream ของตนเป็นแบบบีบอัดและไม่สามารถแก้ไขได้ เนื่องจากการวิเคราะห์นี้ไม่ขยาย object stream ที่เปลี่ยนแปลง
ลูกโซ่ที่ผิดรูปแบบ และการเกินงบจำกัดของรีวิชัน อ็อบเจกต์ หรือการเปลี่ยนแปลง จะคืนค่า prasIndeterminate แทนที่จะเป็นผลลัพธ์แบบอนุญาต
เมธอดนี้ประเมินนโยบายรีวิชันและรูปแบบเงา ให้ใช้ ValidatePades แยกต่างหากสำหรับความถูกต้องเชิงรหัสลับของ CMS

Example

var
  Report: TPadesRevisionAnalysisReport;
begin
  Report := Pdf1.AnalyzeSignatureRevisions;
  if Report.Status in [prasDisallowed, prasSuspicious] then
    ShowMessage('The signed document contains unsafe later revisions');
end;

เมธอด AnalyzeSignatureRevisions