SetDeterministicDocumentID

Propiedades de documentos, optimización

Descripción

Habilita o deshabilita identificadores de archivo de trailer reproducibles derivados de una semilla explícita o del contenido serializado normalizado

Sintaxis

Delphi

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

Parámetros

EnablePase 1 para derivar el identificador de archivo del trailer de una semilla explícita o del contenido del documento normalizado, o 0 para restaurar el identificador predeterminado derivado del tiempo

Valores devueltos

0Valor de parámetro no válido.
1Configuración aplicada con éxito.

Observaciones

Cuando está habilitado, el siguiente guardado completo sin cifrar deriva el /ID del trailer de la semilla suministrada con SetDocumentIDSeed. Sin una semilla explícita, el escritor hace fluir el encabezado serializado y el cuerpo del documento a través de SHA-256, normaliza los identificadores de recursos generados y los UUID de instancia XMP, y usa los primeros 16 bytes del resumen para ambas entradas del array /ID inicial. Los datos de referencias cruzadas, los desplazamientos del trailer y cualquier /ID de trailer previo quedan excluidos, de modo que los cambios de páginas, recursos, adjuntos y metadatos afectan el identificador mientras que los desplazamientos de disposición noEl identificador se actualiza solo en guardados completos. Las actualizaciones incrementales nunca reescriben el identificador permanente, y los documentos cifrados conservan su identificador existente porque la primera entrada

/ID participa en la derivación de la clave de cifrado. Las fechas automáticas y otros metadatos volátiles del usuario permanecen como contenido; establézcalos explícitamente cuando dos documentos generados de forma independiente deban recibir el mismo identificador derivado del contenido

Ejemplo

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

Véase también

GetDeterministicDocumentID, SetDocumentIDSeed, GetDocumentFileID