CreateSelfSignedCertificateA
الأمان والتواقيع
الوصف
الحرف المُلحق A يُشير إلى نقطة دخول ANSI (char) في DLL؛ بينما تكشف واجهة ActiveX/COM الشكل Unicode فقط. السلوك مطابق لـ CreateSelfSignedCertificate وتُفسَّر وسائط السلاسل النصية باستخدام صفحة الرموز الحالية لـ SetAnsiMode
ينشئ مجموعة محتوى اختياري جديدة. وسيظهر اسم المجموعة في تبويب Layers في Acrobat 6 وما بعده
تولد الشهادة في حاوية مفاتيح مؤقتة تُحذف مجددًا بعد التصدير؛ ملف PFX فقط هو الذي يحتفظ بمادة المفتاح. الشهادات الموقعة ذاتيًا مخصصة للاختبار والمستندات الداخلية: تعلّمها عارضات PDF كغير موثوقة ما لم يثبتها المستخدم صراحةً
الصيغة
Delphi
Function DLCreateSelfSignedCertificateA(InstanceID: Integer; SubjectName, PFXFileName, PFXPassword: PAnsiChar; ValidDays, KeyBits: Integer): Integer;
DLL
int DLCreateSelfSignedCertificateA(int InstanceID, const char * SubjectName, const char * PFXFileName, const char * 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 |