EncryptFile

Sikkerhed og signaturer

Beskrivelse

Krypterer en fil på disken og gemmer resultatet i en ny fil. Hele dokumentet behøver ikke at blive indlæst i hukommelsen, så funktionen kan bruges til at kryptere meget store dokumenter.

Syntaks

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

Parametre

InputFileName	Navnet på den fil, der skal krypteres.
OutputFileName	Navnet på den destinationsfil, der skal oprettes
Owner	Den ejeradgangskode, der skal bruges til den krypterede fil. Den kaldes undertiden "master"-adgangskoden eller "permissions"-adgangskoden. Denne adgangskode kræves for at ændre dokumentet. Den brugeradgangskode, der skal bruges til den krypterede fil. Den kaldes undertiden "open"-adgangskoden; den giver brugeren mulighed for at åbne dokumentet, men ikke for at bruge dokumentet på måder, der ikke er tilladt.
User
Strength	Den krypteringsstyrke, der skal bruges: 0 = 40-bit RC4-kryptering 1 = 128-bit RC4-kryptering 2 = 128-bit AES-kryptering (kræver Acrobat 7 eller nyere) 3 = 256-bit AES-kryptering (kræver Acrobat 9 eller nyere) 4 = 256-bit AES-kryptering (kræver Acrobat X eller nyere) 5 = 256-bit AES-GCM-godkendt kryptering (kræver PDF 2.0 med ISO TS 32003)
Permissions	En værdi oprettet med funktionen EncodePermissions

Returværdier

0	Filen kunne ikke krypteres. Kontrollér resultatet af LastErrorCode
1	Dokumentet blev krypteret

Bemærkninger

Kald først SetPDFMACEnabled for at tilføje et selvstændigt PDF MAC-integritetstoken, når styrke 4 eller 5 er valgt