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