EnumCertificates

الأمان والتواقيع

الوصف

تسرد كل شهادة في مخزن شهادات نظام Windows وترجع بيانات التعريف الخاصة بها؛ يحمل كل إدخال الاسمين البسيطين للعرض للموضوع والجهة المصدرة، والرقم التسلسلي (سداسي عشري بحروف كبيرة، البايت الأكثر أهمية أولاً)، ونافذة الصلاحية NotBefore/NotAfter، وعلامة HasPrivateKey (مطلوبة للتوقيع)، وعلامة Qualified (صحيحة عندما تحمل الشهادة ملحق eIDAS QCStatements، المعرف OID 0.4.0.1862.1.7، المكتشف عبر وحدة فك ترميز DER المدمجة)، و CertHandle (سياق PCCERT_CONTEXT الخام)

يكون مقبض CertHandle صالحًا فقط طوال مدة الاستدعاء؛ ويجب على المستدعين الذين يريدون الاحتفاظ بمقبض للتوقيع لاحقًا نسخه عبر CertDuplicateCertificateContext ثم تمريره إلى SetSignProcessCertFromStoreByHandle

الصيغة

Delphi

Function TPDFlib.EnumCertificates(Const StoreName: WideString; UseMachineStore: Boolean; Var Certs: Array Of TPDFlibCertificateInfo): Integer;

المعاملات

StoreNameاسم مخزن نظام Windows ("MY"، "Root"، "CA"، ...)
UseMachineStoreصحيح (True) لـ CERT_SYSTEM_STORE_LOCAL_MACHINE، و خطأ (False) لـ CERT_SYSTEM_STORE_CURRENT_USER
Certsمصفوفة مخصصة من قبل المستدعي ومملوءة ببيانات التعريف الخاصة بالشهادة حتى طولها

قيم الإرجاع

>= 0عدد الشهادات المكتوبة في Certs (قد يكون أقل من حجم المخزن إذا كانت المصفوفة صغيرة جدًا)