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 = تشفير RC4 ‏40 بت 1 = تشفير RC4 ‏128 بت 2 = تشفير AES ‏128 بت (يتطلب Acrobat 7 أو أحدث) 3 = تشفير AES ‏256 بت (يتطلب Acrobat 9 أو أحدث) 4 = تشفير AES ‏256 بت (يتطلب Acrobat X أو أحدث) 5 = تشفير مصادَق AES-GCM ‏256 بت (يتطلب PDF 2.0 مع ISO TS 32003)
Permissionsقيمة أُنشئت بالدالة EncodePermissions

قيم الإرجاع

0تعذّر تشفير الملف. افحص نتيجة LastErrorCode
1شُفّر المستند بنجاح

ملاحظات

استدعِ SetPDFMACEnabled أولًا لإضافة رمز تكامل PDF MAC مستقل عند اختيار قوة 4 أو 5