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 (در صورت کوچک بودن آرایه، ممکن است کمتر از اندازه مخزن باشد)