SetCryptFilterConfiguration

Security, Attachments

Опис

Атомарно обирає, які класи PDF-об'єктів використовуватимуть стандартний crypt-фільтр документа в наступній операції шифрування

Синтаксис

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

Параметри

EncryptStrings	`1` обирає стандартний фільтр для `/StrF`; `0` обирає `Identity`
EncryptStreams	`1` обирає стандартний фільтр для звичайних потоків через `/StmF`; `0` обирає `Identity`
EncryptEmbeddedFiles	`1` обирає стандартний фільтр для потоків вбудованих файлів через `/EFF`; `0` обирає `Identity`

Return values

0	Значення не нуль і не одиниця, всі три цілі вимкнені, не вибрано документа чи шифрування вже почалося
1	Повну цільову конфігурацію прийнято

Примітки

Типове значення — 1, 1, 1, що шифрує рядки, звичайні потоки та вбудовані файли

Вибіркові конфігурації вимагають AES-128, AES-256, AES-256 Acrobat X чи AES-256-GCM і застосовуються послідовно до шифрування паролем, відкритим ключем і відбитком

Устояний метод SetEncryptEmbeddedFilesOnly відображає 1 на 0, 0, 1 і відображає 0 назад на 1, 1, 1

Приклад

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

Див. також

GetEncryptStrings, GetEncryptStreams, GetEncryptEmbeddedFiles, Encrypt, EncryptPublicKey