Método THotPDF.AnalyzeLoadedSignatureRevisions

Classifica cada revisão incremental após uma assinatura selecionada e avalia as mudanças agregadas face a transformações DocMDP, UR/UR3, FieldMDP e Identity

Declarações públicas

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

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

Unit

HPDFDoc

Parâmetros

Nome	Objetivo
`SigIndex`	Índice baseado em zero do campo de assinatura carregado
`Source`	Fluxo pertencente ao chamador que contém os bytes exatos do PDF carregado
`Analysis`	Recebe detalhes de revisão, objeto, campo, permissão, conformidade e diagnóstico

Tipos de mudanças

THPDFRevisionChangeKinds regista de forma independente manutenção de validação de longo prazo, preenchimento de formulários, assinatura, criação/eliminação/modificação de anotações, criação/eliminação/modificação de ficheiros incorporados, instanciação de templates de página e mudanças não reconhecidas

O conjunto de tipos preserva o detalhe de operação que um único nível ordenado de modificação não consegue exprimir e alimenta a correspondência de permissões UR/UR3

Valor devolvido

Devolve True quando o intervalo de bytes da assinatura e a cadeia de revisões foram analisados; caso contrário devolve False e reporta o motivo em Analysis.Issue

Níveis de modificação

THPDFRevisionModificationLevel ordena as alterações semânticas da menos para a mais restritiva

Valor	Significado
`rmlNone`	Sem alterações de objetos pós-assinatura
`rmlLongTermValidation`	Manutenção de DSS, VRI, certificado, revogação, extensão ou carimbo de data/hora do documento
`rmlFormFillAndSign`	Valores de formulário, aparências de widget ou estruturas de assinatura
`rmlAnnotations`	Objetos de anotação ou ligação de anotação de página
`rmlOther`	Objetos irreconhecíveis, ilegíveis, libertados ou de outra forma não permitidos

Detalhes do resultado

THPDFSignatureRevisionAnalysis contém um THPDFSignatureRevisionChangeArray de registos THPDFSignatureRevisionChange

SignedRevisionLength, TotalRevisionCount e SignedRevisionIndex identificam o instantâneo assinado na cadeia cronológica de revisões
Revisions reporta cada desvio xref posterior, nível semântico, números de objetos alterados e libertados, nomes de campos alterados e qualquer questão de classificação conservativa
Permissions contém a mesma informação estrutural DocMDP e FieldMDP devolvida por GetLoadedSignaturePermissions
DocMDPCompliant, FieldMDPCompliant, URCompliant e IdentityCompliant reportam decisões independentes, enquanto TransformCompliant combina todos os métodos de transformação com a validade estrutural
PolicyCompliant continua a ser o resultado final fail-closed para quem precisa de uma única decisão

Notas de utilização

A sobrecarga com suporte de ficheiro abre o ficheiro de origem usado por LoadFromFile; use a sobrecarga de fluxo após LoadFromStream
A posição do fluxo é restaurada antes de o método devolver
Tabelas xref tradicionais, fluxos xref, referências híbridas, cadeias incrementais /Prev e membros de fluxos de objetos comprimidos são suportados
Objetos desconhecidos, ilegíveis ou libertados são classificados como rmlOther para que as verificações de política falhem de forma segura
Anotações libertadas e ficheiros incorporados mantêm a semântica de eliminação dos respetivos corpos de objetos anteriores, enquanto objetos desconhecidos ou ilegíveis permanecem rmlOther, para que as verificações de política falhem em segurança
Este método avalia semântica de revisões e permissões, mas não substitui a verificação criptográfica de assinaturas
SaveIncrementalUpdateAuthenticated combina esta análise com a autenticação da assinatura e a publicação atómica