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)
1Success