SetCryptFilterConfiguration

Безопасность, вложения

Описание

Атомарно выбирает, какие классы 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`

Возвращаемые значения

0	Значение не 0 и не 1, все три цели отключены, документ не выбран или шифрование уже начато
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