SetDeterministicDocumentID

Documenteigenschappen, optimalisatie

Beschrijving

Schakelt reproduceerbare trailer-bestandsidentificatoren in of uit die zijn afgeleid van een expliciete seed of genormaliseerde geserialiseerde inhoud

Syntaxis

Delphi

Function TPDFlib.SetDeterministicDocumentID(Enable: Integer): Integer;

Parameters

Enable	Geef `1` door om de trailer-bestandsidentificator af te leiden uit een expliciete seed of genormaliseerde documentinhoud, of `0` om de standaard tijdgebonden identificator te herstellen

Retourwaarden

0	Ongeldige parameterwaarde
1	Instelling met succes toegepast

Opmerkingen

Wanneer ingeschakeld, leidt de volgende volledige onversleutelde opslag de trailer-/ID af uit de seed die met SetDocumentIDSeed is opgegeven. Zonder expliciete seed streamt de writer de geserialiseerde header en documentbody door SHA-256, normaliseert gegenereerde resource-identificatoren en XMP-instantie-UUID's en gebruikt de eerste 16 digestbytes voor beide items van de initiële /ID-array. Kruisverwijzingsgegevens, trailer-offsets en een eerdere trailer-/ID worden uitgesloten, zodat wijzigingen aan pagina's, resources, bijlagen en metadata de identificator beïnvloeden terwijl lay-outoffsets dat niet doenDe identificator wordt alleen bij volledige opslag ververst. Incrementele updates herschrijven de permanente identificator nooit, en versleutelde documenten behouden hun bestaande identificator omdat het eerste

/ID-item deelneemt aan de afleiding van de versleutelingssleutel. Automatische datums en andere vluchtige gebruikersmetadata blijven inhoud; stel ze expliciet in wanneer twee onafhankelijk gegenereerde documenten dezelfde op inhoud gebaseerde identificator moeten krijgen

Voorbeeld

PDF.SetDeterministicDocumentID(1);
PDF.SetDocumentIDSeed('invoice-2026-07-0001');
PDF.DrawText(100, 100, 'Reproducible output');
PDF.SaveToFile('invoice.pdf'); // same seed, same trailer ID

Zie ook

GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID