EnumCertificates
Security and signatures
Description
هر گواهی را در یک مخزن گواهی سیستم ویندوز شمارش کرده و متادیتای آن را برمیگرداند؛ هر ورودی شامل نامهای نمایش ساده Subject و Issuer، شماره سریال (هگزادسیمال با حروف بزرگ, ابتدا بایت با ارزشتر)، بازه اعتبار NotBefore/NotAfter، پرچم HasPrivateKey (لازم برای امضا), پرچم Qualified (درست است زمانی که گواهی حامل افزونه eIDAS QCStatements با OID 0.4.0.1862.1.7 باشد که از طریق رمزگشای داخلی DER شناسایی میشود) و یک CertHandle (همان PCCERT_CONTEXT خام) است
دستگیره CertHandle فقط در طول مدت فراخوانی معتبر است;فراخوانندگانی که میخواهند دستگیرهای را برای امضای بعدی نگه دارند باید آن را از طریق CertDuplicateCertificateContext تکثیر کرده و سپس به SetSignProcessCertFromStoreByHandle ارسال کنند
Syntax
Delphi
Function TPDFlib.EnumCertificates(Const StoreName: WideString; UseMachineStore: Boolean; Out Certs: Array Of TPDFlibCertificateInfo): Integer;
Parameters
| StoreName | نام مخزن سیستم ویندوز ("MY"، "Root"، "CA"، ...) |
|---|---|
| UseMachineStore | مقدار True برای CERT_SYSTEM_STORE_LOCAL_MACHINE، مقدار False برای CERT_SYSTEM_STORE_CURRENT_USER |
| Certs | آرایه تخصیصیافته توسط فراخواننده که با متادیتای گواهی تا طول آن پر شده است |
Return values
| >= 0 | تعداد گواهیهای نوشتهشده در Certs (در صورت کوچک بودن آرایه، ممکن است کمتر از اندازه مخزن باشد) |
|---|