SetCryptFilterConfiguration

Segurança, anexos

Descrição

Seleciona atomicamente as classes de objetos PDF que utilizam o filtro criptográfico padrão do documento durante a próxima operação de encriptação

Sintaxe

Delphi

Function TPDFlib.SetCryptFilterConfiguration(EncryptStrings, EncryptStreams, EncryptEmbeddedFiles: Integer): Integer;

DLL

Function DLSetCryptFilterConfiguration(InstanceID, EncryptStrings, EncryptStreams, EncryptEmbeddedFiles: Integer): Integer; Stdcall;

ActiveX

Function PDFlib::SetCryptFilterConfiguration(EncryptStrings As Long, EncryptStreams As Long, EncryptEmbeddedFiles As Long) As Long

Parâmetros

EncryptStrings	`1` seleciona o filtro padrão para `/StrF`; `0` seleciona `Identity`
EncryptStreams	`1` seleciona o filtro padrão para fluxos comuns através de `/StmF`; `0` seleciona `Identity`
EncryptEmbeddedFiles	`1` seleciona o filtro padrão para fluxos de ficheiros incorporados através de `/EFF`; `0` seleciona `Identity`

Valores devolvidos

0	Um valor não é zero nem um, os três destinos estão desativados, nenhum documento está selecionado ou a encriptação já foi iniciada
1	A configuração completa do destino foi aceite

Observações

A predefinição é 1, 1, 1, que encripta cadeias, fluxos normais e ficheiros incorporados

As configurações seletivas exigem AES-128, AES-256, AES-256 Acrobat X ou AES-256-GCM e são aplicadas de forma coerente à encriptação por palavra-passe, chave pública e impressão digital

O método estabelecido SetEncryptEmbeddedFilesOnly mapeia 1 para 0, 0, 1 e 0 novamente para 1, 1, 1

Exemplo

PDF.SetCryptFilterConfiguration(0, 1, 0);
PDF.Encrypt('owner-password', 'user-password', 2, Permissions);
PDF.SaveToFile('selective-encryption.pdf');

Consulte também

GetEncryptStrings, GetEncryptStreams, GetEncryptEmbeddedFiles, Encrypt, EncryptPublicKey