السجل THPDFPDFMACValidationInfo

النتيجة الكاملة للتحقق من MAC لـ PDF: الحالة والرسالة وطولا مدى البايتات وMAC وتفاصيل الملخص والسياسة واستخدام AES-GCM وموقع MAC وارتباط التوقيع وأعلام تغطية الأذونات

التصريح

THPDFPDFMACValidationInfo= record
  Status: THPDFPDFMACStatus;
  ByteRangeLength: Int64;
  MACLength: Integer;
  DigestAlgorithm: THPDFPDFMACDigestAlgorithm;
  PolicyProfile: THPDFPDFMACPolicyProfile;
  PolicyAccepted: boolean;
  UsedAESGCM: boolean;
  Message: string;
  Location: THPDFPDFMACLocation;
  SignatureObjectNumber: Integer;
  SignatureGeneration: Integer;
  SignatureDigestMatched: boolean;
  FullFileCoverage: boolean;
  PermissionsAuthenticated: boolean;
  MACRequiredByPermissions: boolean;
end;

الوحدة

HPDFDoc

الحقول

الحقل	الغرض
`Status`	حكم `THPDFPDFMACStatus`: `pmsValid` عندما يجتاز MAC الفحص وحالات إخفاق محددة غير ذلك
`ByteRangeLength`	عدد بايتات الملف الذي تغطيه `/ByteRange` الخاصة بـ MAC
`MACLength`	طول قيمة MAC المرمَّزة
`DigestAlgorithm`	خوارزمية الملخص التي بُني بها MAC المفحوص
`PolicyProfile`	`THPDFPDFMACPolicyProfile` الذي قيِّم MAC في ظله
`PolicyAccepted`	`true` عندما تقبل سياسة الملخص وAES-GCM في الخيارات المعطاة قيمة MAC
`UsedAESGCM`	`true` عندما تكون حمولة MAC محمية بـ AES-GCM
`Message`	نص نتيجة مقروء للإنسان، مثل أن MAC صالح أو سبب عدم صلاحيته
`Location`	`THPDFPDFMACLocation`: MAC مستقل أو آخر مرفق بتوقيع
`SignatureObjectNumber` / `SignatureGeneration`	إحالة كائن التوقيع الملحق به MAC، وذات معنى عندما يبلّغ `Location` عن MAC مرفق بتوقيع
`SignatureDigestMatched`	`true` عندما تطابق ملخص MAC المرفق ملخص بايتات توقيعه
`FullFileCoverage`	`true` عندما يمتد مدى البايتات على الملف كاملًا
`PermissionsAuthenticated`	`true` عندما تغطي قيمة MAC بتات أذونات المستند
`MACRequiredByPermissions`	`true` عندما تفرض أذونات المستند وجود MAC، فيكون غيابه بحد ذاته إخفاق تحقق

ملاحظات الاستخدام

يُملأ عبر THotPDF.ValidatePDFMAC والمتحقق من المراجعات على حدة؛ ويُصفَّر السجل قبل الاستخدام، فافحصه حتى عندما تعيد الدالة false
افحص Status أولًا ثم PolicyAccepted لتمييز MAC سليم تشفيريًا يخفق في ملف تعريفك عن آخر تالف
بالنسبة إلى MAC المرفقة بتوقيع، اقرأ SignatureObjectNumber مع SignatureDigestMatched للتأكد من أن MAC يغطي البايتات نفسها التي وقّعها التوقيع

السجل THPDFPDFMACValidationInfo

التصريح

الوحدة

الحقول

ملاحظات الاستخدام

واجهات برمجة التطبيقات ذات الصلة