EncryptFile

Security and Signatures

Опис

Шифрує файл на диску та зберігає результат у новий файл. Документ не завантажується в пам'ять повністю, тому функція підходить для шифрування величезних документів

Синтаксис

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Пароль власника для зашифрованого файла — його ще називають "master" чи паролем "дозволів"; потрібен для змінення документа Пароль користувача для зашифрованого файла — його ще називають паролем "відкриття"; дозволяє відкрити документ, але не використовувати його способами, які не дозволені
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

Return values

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

Примітки

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