EncryptFile

Безопасность и подписи

Описание

Шифрует файл на диске и сохраняет результат в новый файл. Весь документ не загружается в память, поэтому функция подходит и для огромных документов

Синтаксис

Delphi

Function TPDFlib.EncryptFile(Const InputFileName, OutputFileName, Owner, User: WideString; Strength, Permissions: Integer): Integer;

ActiveX

Function PDFlib::EncryptFile(InputFileName As String, OutputFileName As String, Owner As String, User As String, Strength As Long, Permissions As Long) As Long

DLL

int DLEncryptFile(int InstanceID, const wchar_t * InputFileName, const wchar_t * OutputFileName, const wchar_t * Owner, const wchar_t * User, int Strength, int Permissions);

Параметры

InputFileNameИмя шифруемого файла
OutputFileNameИмя создаваемого целевого файла
OwnerПароль владельца для шифруемого файла — его ещё называют "мастер"-паролем или паролем разрешений; он нужен для изменения документа. Пароль пользователя для шифруемого файла — его ещё называют паролем открытия; он позволяет открыть документ, но не даёт использовать его сверх разрешённого
User
StrengthСтойкость шифрования: 0 = 40-битный RC4 1 = 128-битный RC4 2 = 128-битный AES (нужен Acrobat 7+) 3 = 256-битный AES (нужен Acrobat 9+) 4 = 256-битный AES (нужен Acrobat X+) 5 = 256-битное аутентифицированное шифрование AES-GCM (нужен PDF 2.0 с ISO TS 32003)
PermissionsЗначение, созданное функцией EncodePermissions

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

0Файл не удалось зашифровать; проверьте результат LastErrorCode
1Документ зашифрован успешно

Примечания

Сначала вызовите SetPDFMACEnabled, чтобы добавить отдельный маркер целостности PDF MAC при выбранной силе 4 или 5