THPDFHeadlessAES256Security

Diese Klasse in HPDFHeadlessSecurity authentifiziert Standard-V=5-Verschlüsselungsdictionaries mit R=5 oder R=6 und AESV3-DocOpen-Crypt-Filter über die gemeinsamen HotPDF-Kryptoimplementierungen

Create(EncryptionDictionary, Password, CancellationToken) akzeptiert ein Aufrufer-Dictionary, ein Unicode-Passwort und ein optionales Cancellation-Token des Aufrufers; Passwörter nutzen UTF-8-Bytes, abgeschnitten bei 127 Bytes, ohne SASLprep-Normalisierung

Owner-Authentifizierung wird vor User-Authentifizierung versucht, OE oder UE holt den 256-Bit-Dateischlüssel, und Perms authentifiziert die Berechtigungsmaske und die EncryptMetadata-Policy; beim Zerstören wird der vorgehaltene Schlüssel verworfen

DecryptString und EncryptString folgen StrF, während DecryptStream(Data, IsMetadata) und EncryptStream(Data, IsMetadata) StmF und EncryptMetadata folgen; IsMetadata steht standardmäßig auf false, Identity lässt Bytes unverändert, und verschlüsselte Nutzdaten tragen einen frischen 16-Byte-IV und PKCS7-Padding

RequireTextExtractionPermission prüft Berechtigungsbit 5, und RequireFormFillPermission prüft Bit 9; authentifizierte Owner-Passwörter umgehen diese User-Berechtigungsbeschränkungen

Read-only-Properties sind Revision, OwnerAuthenticated, PermissionMask, EncryptMetadata, EncryptStrings und EncryptStreams

Fehler lösen EHPDFHeadlessSecurityError aus; Abbruch behält EHPDFOperationCancelled bei, und Aufrufer müssen bei direkter Nutzung dieses Providers die Ausnahmen für xref, Object-Stream, Verschlüsselungs-Dictionary, Trailer-ID und Signatur-Contents selbst anwenden

RC4, AES-128, Public-Key-Handler, AES-GCM, explizite Stream-Crypt-Filter und PDF-MAC-Prüfung erfordern separate Policies; dieser Provider erzeugt keine Verschlüsselungsdictionaries und ändert keine Dokumentberechtigungen