THPDFPDFMACValidationInfo Record

Vollständiges Ergebnis einer PDF-MAC-Validierung: Status und Meldung, Byte-Range- und MAC-Längen, Digest- und Policy-Details, AES-GCM-Verwendung, MAC-Position, Signaturverknüpfung und Berechtigungsabdeckungs-Flags

Deklaration

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;

Unit

HPDFDoc

Felder

Feld	Zweck
`Status`	`THPDFPDFMACStatus`-Urteil, `pmsValid`, wenn der MAC in Ordnung war, sonst spezifische Fehlerzustände
`ByteRangeLength`	Anzahl vom `/ByteRange` des MAC abgedeckter Datei-Bytes
`MACLength`	Länge des kodierten MAC-Werts
`DigestAlgorithm`	Digest-Algorithmus, mit dem der geprüfte MAC gebaut wurde
`PolicyProfile`	`THPDFPDFMACPolicyProfile`, unter dem der MAC bewertet wurde
`PolicyAccepted`	`true`, wenn die Digest- und AES-GCM-Policy der übergebenen Optionen den MAC akzeptierte
`UsedAESGCM`	`true`, wenn die MAC-Nutzdaten AES-GCM-geschützt waren
`Message`	Menschenlesbarer Ergebnistext, etwa dass der MAC gültig ist, oder der Grund, warum nicht
`Location`	`THPDFPDFMACLocation`: Standalone-MAC oder ein an eine Signatur angehängter
`SignatureObjectNumber` / `SignatureGeneration`	Objektreferenz der Signatur, an der der MAC hängt; relevant, wenn `Location` einen angehängten MAC meldet
`SignatureDigestMatched`	`true`, wenn der Digest eines angehängten MAC zum Byte-Digest seiner Signatur passte
`FullFileCoverage`	`true`, wenn der Bytebereich die gesamte Datei umspannt
`PermissionsAuthenticated`	`true`, wenn die Berechtigungsbits des Dokuments vom MAC abgedeckt waren
`MACRequiredByPermissions`	`true`, wenn die Berechtigungen des Dokuments einen MAC verlangen, sodass ein fehlender MAC selbst ein Validierungsfehler ist

Verwendungshinweise

Gefüllt von THotPDF.ValidatePDFMAC und dem je-Revision-Validierer; der Record wird vor der Verwendung zurückgesetzt, also inspizieren Sie ihn auch dann, wenn die Funktion false zurückgibt
Prüfen Sie zuerst Status, dann PolicyAccepted, um einen kryptografisch einwandfreien MAC, der an Ihrem Profil scheitert, von einem defekten zu unterscheiden
Lesen Sie bei angehängten MACs SignatureObjectNumber zusammen mit SignatureDigestMatched, um zu bestätigen, dass der MAC dieselben Bytes abdeckt, die die Signatur signiert hat

THPDFPDFMACValidationInfo Record

Deklaration

Unit

Felder

Verwendungshinweise

Verwandte APIs