EncryptFile

Zabezpieczenia i podpisy

Opis

Szyfruje plik na dysku i zapisuje wynik do nowego pliku. Cały dokument nie musi być wczytywany do pamięci, dlatego funkcji można używać do szyfrowania bardzo dużych dokumentów

Składnia

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);

Parametry

InputFileName	Nazwa pliku do zaszyfrowania
OutputFileName	Nazwa tworzonego pliku docelowego
Owner	Hasło właściciela używane dla zaszyfrowanego pliku. Jest ono czasem nazywane hasłem "głównym" lub hasłem "uprawnień". Będzie wymagane do zmiany dokumentu. Hasło użytkownika używane dla zaszyfrowanego pliku. Jest ono czasem nazywane hasłem "otwarcia"; pozwala użytkownikowi otworzyć dokument, ale nie korzystać z niego w niedozwolony sposób
User
Strength	Używana siła szyfrowania: 0 = szyfrowanie 40-bitowe RC4 1 = szyfrowanie 128-bitowe RC4 2 = szyfrowanie 128-bitowe AES (wymaga Acrobat 7 lub nowszego) 3 = szyfrowanie 256-bitowe AES (wymaga Acrobat 9 lub nowszego) 4 = szyfrowanie 256-bitowe AES (wymaga Acrobat X lub nowszego) 5 = uwierzytelnione szyfrowanie 256-bitowe AES-GCM (wymaga PDF 2.0 z ISO TS 32003)
Permissions	Wartość utworzona za pomocą funkcji EncodePermissions

Wartości zwracane

0	Nie można było zaszyfrować pliku. Sprawdź wynik LastErrorCode
1	Dokument został pomyślnie zaszyfrowany

Uwagi

Najpierw wywołaj SetPDFMACEnabled, aby dodać samodzielny token integralności PDF MAC po wybraniu siły 4 lub 5