DAOpenFromStreamWithEncryptionKey
إدارة المستندات، وظائف الوصول المباشر، الأمان، إدخال من التدفقات
الوصف
يفتح تيارًا قابلًا للتموضع مشفرًا للاستعادة أو الفحص المصرَّح به بقبول مفتاح تشفير الملف السداسي عشري مباشرةً بدل اشتقاقه من كلمة مرور
الصيغة
Delphi
Function TPDFlib.DAOpenFromStreamWithEncryptionKey(InStream: TStream; Const EncryptionKeyHex: WideString; Options: Integer = 0): Integer;المعاملات
| InStream | تيار PDF قابل للتموضع غير معدوم يبقى مملوكًا للمستدعي |
|---|---|
| EncryptionKeyHex | مفتاح سداسي عشري ASCII طوله زوجي بلا بادئة أو فراغات وبالطول تمامًا الذي يتطلبه إصدار التشفير |
| Options | الصفر يوجب وجود قيمة تحقق متاحة؛ ويسمح PDF_RAW_KEY_ALLOW_UNVERIFIED بمفتاح صالح لولا ذلك فقط عندما لا يملك المستند قيمة تحقق قابلة للاستخدام |
القيم المُرجعة
| قيمة غير صفرية | مقبض ملف Direct Access |
|---|---|
| 0 | تعذر فتح المدخل؛ افحص LastErrorCode |
ملاحظات
لا تملك المكتبة InStream أبدًا وإغلاق مقبض الوصول المباشر يتركه قابلًا للاستخدام من المستدعي
تُفحص المدققات المتاحة دائمًا ولا يُقبل عدم التطابق أبدًا
DAGetEncryptionKeyValidation بعد الفتح لفحص نتيجة التحقق