EncryptFile

Security and Signatures

Kuvaus

Salaa levyllä olevan tiedoston ja tallentaa tuloksen uuteen tiedostoon. Koko asiakirjaa ei tarvitse ladata muistiin, joten tällä funktiolla voi salata myös jättimäisiä asiakirjoja

Syntaksi

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

Parametrit

InputFileNameSalattavan tiedoston nimi
OutputFileNameLuotavan kohdetiedoston nimi
OwnerSalatun tiedoston omistajasalasana. Sitä kutsutaan joskus "master"- tai "permissions"-salasanaksi. Salasana tarvitaan asiakirjan muuttamiseen Salatun tiedoston käyttäjäsalasana. Sitä kutsutaan joskus "avaus"-salasanaksi; se sallii käyttäjän avata asiakirjan, mutta ei käyttää asiakirjaa sallitun ulkopuolisilla tavoilla
User
StrengthKäytettävä salauksen vahvuus: 0 = 40-bittinen RC4-salaus 1 = 128-bittinen RC4-salaus 2 = 128-bittinen AES-salaus (vaatii Acrobat 7:n tai uudemman) 3 = 256-bittinen AES-salaus (vaatii Acrobat 9:n tai uudemman) 4 = 256-bittinen AES-salaus (vaatii Acrobat X:n tai uudemman) 5 = 256-bittinen AES-GCM-todennettu salaus (vaatii PDF 2.0:n ISO TS 32003:n kanssa)
PermissionsEncodePermissions-funktiolla luotu arvo

Return values

0Tiedostoa ei voitu salata. Tarkista LastErrorCode-funktion tulos
1Asiakirjan salaus onnistui

Remarks

Call SetPDFMACEnabled first to add a standalone PDF MAC integrity token when strength 4 or 5 is selected