Método THotPDF.AnalyzeLoadedSignatureRevisions

Clasifica cada revisión incremental posterior a una firma seleccionada y evalúa los cambios agregados frente a DocMDP y FieldMDP

Declaraciones

function AnalyzeLoadedSignatureRevisions(
  SigIndex: Integer;
  Source: TStream;
  out Analysis: THPDFSignatureRevisionAnalysis
): boolean; overload;

function AnalyzeLoadedSignatureRevisions(
  SigIndex: Integer;
  out Analysis: THPDFSignatureRevisionAnalysis
): boolean; overload;

Unidad

HPDFDoc

Parámetros

Nombre	Finalidad
`SigIndex`	Índice basado en cero del campo de firma cargado
`Source`	Flujo propiedad del llamador que contiene los bytes exactos del PDF cargado
`Analysis`	Recibe los detalles de revisión, objeto, campo, permiso, cumplimiento y diagnóstico

Tipos de cambios

THPDFRevisionChangeKinds registra de forma independiente el mantenimiento de validación a largo plazo, el relleno de formularios, el firmado, la creación/borrado/modificación de anotaciones, la creación/borrado/modificación de archivos incrustados, la instanciación de plantillas de página y los cambios no reconocidos

El conjunto de tipos preserva el detalle de operación que un único nivel de modificación ordenado no puede expresar, y dirige la coincidencia de permisos UR/UR3

Valor devuelto

Devuelve True cuando se analizaron el rango de bytes de la firma y la cadena de revisiones; de lo contrario devuelve False y notifica el motivo en Analysis.Issue

Niveles de modificación

THPDFRevisionModificationLevel ordena los cambios semánticos de menor a mayor restricción

Valor	Significado
`rmlNone`	Sin cambios de objetos posteriores a la firma
`rmlLongTermValidation`	Mantenimiento de DSS, VRI, certificados, revocación, extensiones o marcas de tiempo del documento
`rmlFormFillAndSign`	Valores de formulario, apariencias de widgets o estructuras de firma
`rmlAnnotations`	Objetos de anotación o vinculación de anotaciones de página
`rmlOther`	Objetos no reconocidos, no legibles, liberados o no permitidos por cualquier otro motivo

Detalles del resultado

THPDFSignatureRevisionAnalysis contiene un THPDFSignatureRevisionChangeArray de registros THPDFSignatureRevisionChange

SignedRevisionLength, TotalRevisionCount y SignedRevisionIndex identifican la instantánea firmada dentro de la cadena cronológica de revisiones
Revisions informa de cada offset xref posterior, nivel semántico, conjunto de tipos de cambio, números de objeto modificados y liberados, nombres de campo modificados y cualquier incidencia de clasificación conservadora
Permissions contiene la información de transform completa reconstruida a partir de la revisión firmada exacta, en lugar de una política potencialmente redefinida en el grafo de objetos más reciente
DocMDPCompliant, FieldMDPCompliant, URCompliant y IdentityCompliant informan decisiones independientes, mientras que TransformCompliant combina todos los métodos de transform con la validez estructural
PolicyCompliant sigue siendo el resultado final a prueba de fallos para los llamadores que necesitan una única decisión

Notas de uso

La sobrecarga basada en archivo abre el archivo fuente usado por LoadFromFile; use la sobrecarga de stream después de LoadFromStream
La posición del stream se restaura antes de que el método regrese
Se admiten tablas xref tradicionales, xref streams, referencias híbridas, cadenas /Prev incrementales y miembros comprimidos de object-streams
UR3 participa mediante su rango de bytes obligatorio; las firmas UR legadas obsoletas no tienen frontera de revisión firmada, así que este método informa de un /ByteRange no válido o ausente en lugar de intentar el algoritmo obsoleto de digest de objetos
Las anotaciones liberadas y los archivos incrustados conservan la semántica de borrado de sus cuerpos de objeto previos, mientras que los objetos desconocidos o ilegibles permanecen como rmlOther para que las comprobaciones de políticas fallen de forma segura
Este método evalúa la semántica de revisiones y los permisos, pero no sustituye a la verificación criptográfica de firmas
SaveIncrementalUpdateAuthenticated combina este análisis con la autenticación de firmas y la publicación atómica