SetCryptFilterConfiguration

Segurança, Anexos

Descrição

Seleciona atomicamente quais classes de objetos PDF usam o crypt filter padrão do documento durante a próxima operação de criptografia

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 streams comuns via `/StmF`; `0` seleciona `Identity`
EncryptEmbeddedFiles	`1` seleciona o filtro padrão para streams de arquivos embutidos via `/EFF`; `0` seleciona `Identity`

Valores retornados

0	Um valor não é zero nem um, os três alvos estão desabilitados, nenhum documento está selecionado, ou a criptografia já começou
1	A configuração de alvo completa foi aceita

Observações

O padrão é 1, 1, 1, que criptografa strings, streams comuns e arquivos embutidos

Configurações seletivas exigem AES-128, AES-256, AES-256 Acrobat X ou AES-256-GCM e são aplicadas de forma consistente à criptografia por senha, chave pública e fingerprint

O método já estabelecido SetEncryptEmbeddedFilesOnly mapeia 1 para 0, 0, 1 e mapeia 0 de volta para 1, 1, 1

Exemplo

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

Veja também

GetEncryptStrings, GetEncryptStreams, GetEncryptEmbeddedFiles, Encrypt, EncryptPublicKey