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Паролата на собственика, която да се използва за криптирания файл. Тази парола понякога се нарича "master" парола или парола за "permissions". Тази парола ще е нужна за промяна на документа. Потребителската парола, която да се използва за криптирания файл. Тази парола понякога се нарича "open" парола; тя ще позволи на потребителя да отвори документа, но не и да го използва по начини, които не са разрешени
User
StrengthСилата на използваното шифроване: 0 = 40-битово шифроване RC4 1 = 128-битово шифроване RC4 2 = 128-битово шифроване AES (изисква Acrobat 7 или по-нова версия) 3 = 256-битово шифроване AES (изисква Acrobat 9 или по-нова версия) 4 = 256-битово шифроване AES (изисква Acrobat X или по-нова версия) 5 = удостоверено шифроване AES-GCM с 256 бита (изисква PDF 2.0 с ISO TS 32003)
PermissionsСтойност, създадена с функцията EncodePermissions

Върнати стойности

0Файлът не можа да бъде криптиран. Проверете резултата от LastErrorCode
1Документът беше криптиран успешно

Забележки

Първо извикайте SetPDFMACEnabled, за да добавите самостоятелен токен за целостност PDF MAC, когато е избрана сила 4 или 5