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