SetSignProcessCNGKeyFromFile
الأمان والتواقيع
الوصف
يحمّل شهادة X.509 مرمزة بـ DER من ملف ويلحق مفتاح NCrypt خاصًا مسمى بعملية توقيع PDF
الصيغة
Delphi
Function TPDFlib.SetSignProcessCNGKeyFromFile(SignProcessID: Integer; Const CertificateFile, ProviderName, KeyName: WideString; UseMachineKey, AllowUI: Boolean): Integer;
ActiveX
Function PDFlib::SetSignProcessCNGKeyFromFile(SignProcessID As Long, CertificateFile As String, ProviderName As String, KeyName As String, UseMachineKey As Long, AllowUI As Long) As Long
DLL
int DLSetSignProcessCNGKeyFromFile(int InstanceID, int SignProcessID, const wchar_t* CertificateFile, const wchar_t* ProviderName, const wchar_t* KeyName, int UseMachineKey, int AllowUI);
المعاملات
| CertificateFile | مسار شهادة X.509 من نوع RSA أو ECDSA مرمزة بـ DER |
|---|---|
| ProviderName | اسم مزود تخزين مفاتيح Windows أو سلسلة فارغة لمزود برمجيات Microsoft |
| KeyName | اسم مفتاح دائم يفهمه المزود |
| UseMachineKey | true أو غير صفري لاستخدام نطاق مفتاح الجهاز |
| AllowUI | true أو غير صفري للسماح بتفاعل المزود |
قيم الإرجاع
| 1 | قُرئت الشهادة وأُلحقت التهيئة |
|---|---|
| 0 | كان الملف أو معرّف العملية أو اسم المفتاح غير صالح |
ملاحظات
تصدر DLL كذلك DLSetSignProcessCNGKeyFromFileA للمسارات والأسماء ANSI
تحتفظ عملية التوقيع ببايتات الشهادة بينما يبقى المفتاح الخاص داخل مزوده