EncryptFileA

Security and Signatures

Kuvaus

Loppuosa A tarkoittaa DLL:n ANSI-pistettä (char); ActiveX/COM-rajapinta tarjoaa vain Unicode-muodon. Käyttäytyminen on sama kuin funktiolla EncryptFile, ja merkkijonoargumentit tulkitaan nykyisellä SetAnsiMode-koodisivulla

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 DLEncryptFileA(InstanceID: Integer; InputFileName, OutputFileName, Owner, User: PAnsiChar; Strength, Permissions: Integer): Integer;

DLL

int DLEncryptFileA(int InstanceID, const char * InputFileName, const char * OutputFileName, const char * Owner, const char * 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 Acorbat X:n tai uudemman)
PermissionsEncodePermissions-funktiolla luotu arvo

Return values

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