PDFium Delphi Component Docs

เมธอด ValidatePadesTrustAsync

Component: TPdf  ·  Unit: PDFium
ตรวจสอบความน่าเชื่อถือของลายเซ็น PAdES บนเธรด worker และรายงานผลผ่านคอลแบ็ก

Syntax

function ValidatePadesTrustAsync(const Options: TPadesTrustValidationOptions; const Reply: TPadesTrustValidationReply): Boolean;

OptionsTPadesTrustValidationOptions ประกอบด้วย NetworkPolicy, CheckRevocation, CheckTimeStamps, UrlRetrievalTimeoutMs, CancellationToken ที่ไม่บังคับ และเฮนเดิล OnProgress โดย TPadesTrustValidationOptions.Default ให้จุดตั้งต้นที่ใช้งานได้
ReplyTPadesTrustValidationReply เมธอดที่ถูกเรียกเมื่อการตรวจสอบเสร็จ ในรูป procedure(Sender: TObject; const Completion: TPadesTrustValidationCompletion) of object ค่า nil จะทำให้การเรียกคืน False
ResultBoolean เป็น True เมื่อ worker ถูกเริ่มแล้ว ซึ่งไม่ใช่ผลลัพธ์ของการตรวจสอบ

Description

การตรวจสอบความน่าเชื่อถืออาจต้องดึง CRL คำตอบ OCSP และใบรับรองของ timestamp ผ่านเครือข่าย จึงกินเวลาหลายวินาทีได้ การรันบน worker ช่วยให้อินเทอร์เฟซผู้ใช้ยังตอบสนองได้ในจุดที่ ValidatePadesTrust จะบล็อก

เรคอร์ดการเสร็จสิ้นบรรจุผลลัพธ์ Validation ที่เสร็จแล้ว พร้อม Status, ErrorMessage และ ErrorClassName เมื่อรันไม่สำเร็จ และ CancellationReason เมื่อโทเคนสั่งหยุด ผู้เรียกจึงรู้ไม่เพียงว่าจบแล้ว แต่รู้ด้วยว่าจบอย่างไร

ไบต์ของเอกสารถูกจับภาพไว้ล่วงหน้า ดังนั้นค่า False ที่คืนมายังรวมถึงกรณีเอกสารที่ไม่ได้ active หรือกำลังโหลดแบบ progressive อยู่ด้วย ส่วน Options.NetworkPolicy เป็นตัวกำหนดว่าจะพยายามเข้าถึงเครือข่ายเลยหรือไม่

See Also

ValidatePadesTrust, ValidatePades, AnalyzeSignatureRevisions, SignPades