CreateSelfSignedCertificate
الأمان والتواقيع
الوصف
ينشئ مجموعة محتوى اختياري جديدة. وسيظهر اسم المجموعة في تبويب Layers في Acrobat 6 وما بعده
تولد الشهادة في حاوية مفاتيح مؤقتة تُحذف مجددًا بعد التصدير؛ ملف PFX فقط هو الذي يحتفظ بمادة المفتاح. الشهادات الموقعة ذاتيًا مخصصة للاختبار والمستندات الداخلية: تعلّمها عارضات PDF كغير موثوقة ما لم يثبتها المستخدم صراحةً
الصيغة
Delphi
Function TPDFlib.CreateSelfSignedCertificate(Const SubjectName, PFXFileName, PFXPassword: WideString; ValidDays, KeyBits: Integer): Integer;
ActiveX
Function PDFlib::CreateSelfSignedCertificate(SubjectName As String, PFXFileName As String, PFXPassword As String, ValidDays As Long, KeyBits As Long) As Long
DLL
int DLCreateSelfSignedCertificate(int InstanceID, const wchar_t * SubjectName, const wchar_t * PFXFileName, const wchar_t * PFXPassword, int ValidDays, int KeyBits);
المعاملات
| SubjectName | موضوع الشهادة كسلسلة X.500، مثل "CN=Alice Signer, O=Example Corp". ويُسبق الاسم المجرّد بلا "=" تلقائيًا ببادئة "CN=" |
|---|---|
| PFXFileName | مسار ملف PFX (PKCS#12) المطلوب كتابته |
| PFXPassword | كلمة المرور التي تحمي ملف PFX المُصدَّر |
| ValidDays | مدة الصلاحية بالأيام من الآن؛ القيم الأقل من 1 تعود إلى 365 |
| KeyBits | طول مفتاح RSA بالبت؛ القيم خارج 1024..16384 تعود إلى 2048 افتراضيًا |
قيم الإرجاع
| 0 | تعذّر إنشاء الشهادة (موضوع أو اسم ملف فارغ، أو فشل في Windows CryptoAPI) |
|---|---|
| 1 | Success |