SaveAsEncrypted - TPdf - PDFium Delphi Component

Componente: TPdf · Unidade: PDFium

Guarda o PDF ativo com encriptação AES-256-CBC ou ISO/TS 32003 AES-256-GCM selecionada por TPdfEncryptOptions

Syntax

function SaveAsEncrypted(const FileName: string; const Options: TPdfEncryptOptions): Boolean;

FileName	string. O caminho do ficheiro de destino
Options	TPdfEncryptOptions. Record de configuração que define palavras-passe, permissões, flags de encriptação de metadados e a revisão de encriptação

Return Value

Devolve True se o PDF encriptado foi guardado com sucesso, ou False em caso de falha

Description

SaveAsEncrypted suporta os security handlers AESV3-CBC R=5 e R=6 da ISO 32000-2, mais o security handler AESV4-GCM R=7 da ISO/TS 32003

Defina Options.Revision como erR7 para encriptação autenticada por objeto, com IVs únicos de 12 bytes e tags de 16 bytes

Remarks

Este método remove temporariamente qualquer segurança existente usando saRemoveSecurity, para garantir que os objetos em texto simples são serializados de forma limpa antes de serem encriptados pela varredura pós-gravação
As permissões do chamador são definidas com os valores padrão de máscara de bits especificados na Table 22 da norma ISO 32000-1
As compilações atuais do PDFium não carregam AESV4 diretamente; use DecryptAesGcmDocumentBytes antes de TPdf.LoadDocument

Example

var
  Opts: TPdfEncryptOptions;
begin
  Opts := TPdfEncryptOptions.Default;
  Opts.UserPassword := 'user123';
  Opts.OwnerPassword := 'owner123';
  Opts.Permissions := $FFFFFFF0;
  Opts.EncryptMetadata := True;
  Opts.Revision := erR7;
  if Pdf1.SaveAsEncrypted('encrypted.pdf', Opts) then
    ShowMessage('Encrypted PDF saved successfully');
end;

Método SaveAsEncrypted