THPDFHeadlessDocument.SignToFile

function SignToFile(FieldIndex: Integer; const FileName: string;
  const CertificatePEM, PrivateKeyPEM: SysUtils.TBytes;
  const Options: THPDFHeadlessCMSOptions;
  ReservedCMSBytes: Integer = 16384): THPDFHeadlessCMSResult;

Signerer et eksisterende usigneret AcroForm-signaturfelt og publicerer atomisk et uafhængigt output på native Linux eller Windows

FieldIndex er det nul-baserede formularfeltindeks, som FindFormField eller GetFormField returnerer, som kan afvige fra et signeret-signatur-indeks, som VerifySignature accepterer

Certifikatet og matchende privatnøgle skal være PEM-bytes; krypterede private nøgler afvises uden at spørge, og OpenSSL 3 indlæses gennem samme provider som HPDFSignHeadlessCMS

ReservedCMSBytes reserverer et fast hexadecimalt Contents-gap inden hashing; det skal være positivt, passe i dokumentets objektbudget og rumme den komplette genererede CMS DER

Standardprofilen er adbe.pkcs7.detached; RequireCAdES=true skriver ETSI.CAdES.detached og inkluderer en signing-certificate-attribut, dokumentverifikation autentificerer automatisk dens ESS-binding med eksplicit CA trust vurderet separat

Writeren kopierer kilde-bytes, tilføjer erstatningsfeltværdier og et nyt signaturobjekt gennem den delte xref-writer, patcher fastbreddede ByteRange-pladser, signerer de faktiske staging-fil-intervaller og verificerer den resulterende CMS inden flush og atomisk publicering

Hver ældre approval-signatur beholder sine eksakte originale bytes; dens verifikationsresultat rapporterer en gyldig tidligere revision og antallet af senere usignerede bytes

Kilden åbnes skrivebeskyttet, den indlæste feltgraf ændres ikke af signeringen, og kildesti-aliasser eller fysiske fil-aliasser afvises

Fejl bevarer en eksisterende destination og sletter den upublicerede staging-fil, inklusive cancellation, utilstrækkelige reservationer, certifikat/nøgle-fejl, kryptografiske fejl samt objekt- eller filbudget-opbrug

Skrivebeskyttede felter, signede feltværdier, ikke-tilladte certificeret dokument-politikker og nægtede AES form-fill-tilladelser afvises; owner-autentifikation kan autorisere begrænsede kilder, mens outputtet beholder den originale user-adgangskode og sikkerhedspolitik

CertificationPermission fra 1 til 3 opretter en første certificeringssignatur med katalog Perms.DocMDP og en SigRef-transform; nul opretter en approval-signatur, inklusive en tilladt efterfølgende signatur i et eksisterende felt under DocMDP P2 eller P3

Dokument- og CMS-options skal bruge samme cancellation-token, hvis begge angiver én; ellers nedarver CMS-provideren dokument-tokenet

Den returnerede THPDFHeadlessCMSResult adskiller integritet fra eksplicit vurderet CA trust; intet timestamp-, revocation- eller langtidsvalideringskonklusion indebæres

Brug AddSignatureField og SetSignatureFieldAppearance til at forberede en ny synlig signatur-widget, eller SignPFXToFile til at indlæse en PKCS12-identitet gennem OpenSSL 3

Brug TimestampToFile til at tilføje et selvstændigt RFC3161 dokumenttidsstempel uden en applikationssigneringsidentitet