EncryptFileA

Security and Signatures

الوصف

تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ EncryptFile وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية

يشفّر ملفًا على القرص ويحفظ النتيجة في ملف جديد. لا يلزم تحميل المستند بأكمله في الذاكرة لذا يمكن استخدام هذه الدالة لتشفير مستندات ضخمة

Syntax

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

Parameters

InputFileNameاسم الملف المطلوب تشفيره
OutputFileNameاسم ملف الوجهة المطلوب إنشائه
Ownerكلمة مرور المالك المستخدمة للملف المشفر، وتسمى أحيانًا كلمة المرور "الرئيسية" أو كلمة مرور "الأذونات". وستلزم هذه الكلمة لتغيير المستند. كلمة مرور المستخدم المستخدمة للملف المشفر، وتسمى أحيانًا كلمة مرور "الفتح"، وتتيح للمستخدم فتح المستند دون استخدامه بطرق غير مسموح بها
User
Strengthقوة التشفير المستخدمة: ‏0 = تشفير RC4 ‏40 بت 1 = تشفير RC4 ‏128 بت 2 = تشفير AES ‏128 بت (يتطلب Acrobat 7 أو أحدث) 3 = تشفير AES ‏256 بت (يتطلب Acrobat 9 أو أحدث) 4 = تشفير AES ‏256 بت (يتطلب Acorbat X أو أحدث)
Permissionsقيمة أُنشئت بالدالة EncodePermissions

Return values

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