DAOpenFileWithEncryptionKeyA
إدارة المستندات، وظائف الوصول المباشر، الأمان
الوصف
تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ ولا تكشف واجهة ActiveX/COM إلا الصيغة يونيكودية. السلوك مطابق لـ DAOpenFileWithEncryptionKey وتُفسَّر وسائط السلاسل وفق صفحة الأكواد الحالية في SetAnsiModeيفتح PDF مشفرًا للاستعادة أو الفحص المصرَّح به بقبول مفتاح تشفير الملف السداسي عشري مباشرةً بدل اشتقاقه من كلمة مروريُفتح الملف عبر مقبض مصدر للقراءة فقط ولا يمكن الإلحاق به في مكانه
الصيغة
Delphi
Function DLDAOpenFileWithEncryptionKeyA(InstanceID: Integer; InputFileName, EncryptionKeyHex: PAnsiChar; Options: Integer): Integer; Stdcall;DLL
int DLDAOpenFileWithEncryptionKeyA(int InstanceID, const char * InputFileName, const char * EncryptionKeyHex, int Options);المعاملات
| InputFileName | مسار واسم ملف PDF المشفر |
|---|---|
| EncryptionKeyHex | مفتاح سداسي عشري ASCII طوله زوجي بلا بادئة أو فراغات؛ وتتطلب الإصدارات من 2 إلى 4 طول المفتاح تمامًا المعلن في قاموس التشفير، بينما تتطلب الإصدارات من 5 إلى 7 ما يبلغ 32 بايت |
| Options | الصفر يوجب وجود قيمة تحقق متاحة؛ ويسمح PDF_RAW_KEY_ALLOW_UNVERIFIED بمفتاح صالح لولا ذلك فقط عندما لا يملك المستند قيمة تحقق قابلة للاستخدام |
القيم المُرجعة
| قيمة غير صفرية | مقبض ملف Direct Access |
|---|---|
| 0 | تعذر فتح المدخل؛ افحص LastErrorCode، ومن بينها PDFLIB_ERROR_RAW_ENCRYPTION_KEY_INVALID لبنية أو طول أو خيارات أو تحقق غير صالح |
ملاحظات
تُفحص دائمًا قيم /U المتاحة للإصدارات من 2 إلى 4 وقيم /Perms للإصدارات من 5 إلى 7؛ ولا يقبل PDF_RAW_KEY_ALLOW_UNVERIFIED عدم تطابق أبدًااستدع
DAGetEncryptionKeyValidation بعد الفتح للتمييز بين المقابض المحققة والمقابض غير المحققة صراحةًتُوسَّع سلاسل ANSI وفق صفحة الأكواد الحالية في
SetAnsiMode قبل معالجة الطلبالمفتاح مادة اعتماد حساسة ينبغي الحصول عليها ونقلها وتخزينها تحت الضوابط نفسها المعمول بها لكلمة مرور مستند