Encrypt

الأمان والتواقيع

الوصف

تضيف هذه الدالة إعدادات الأمان المحددة إلى المستند المحدد

يُؤجَّل التشفير الفعلي للمستند حتى حفظ المستند، فيمكن استدعاء هذه الدالة في أي وقت، حتى قبل إضافة المزيد من المحتوى إلى المستند

الصيغة

Delphi

Function TPDFlib.Encrypt(Const Owner, User: WideString; Strength, Permissions: Integer): Integer;

ActiveX

Function PDFlib::Encrypt(Owner As String, User As String, Strength As Long, Permissions As Long) As Long

DLL

int DLEncrypt(int InstanceID, const wchar_t * Owner, const wchar_t * User, int Strength, int Permissions);

المعاملات

Ownerكلمة مرور المالك أو الرئيسية للمستند
Userكلمة مرور المستخدم للمستند
Strengthقوة التشفير المستخدمة: ‏0 = تشفير 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