EnumCertificates

Security and signatures

Description

Enumera ogni certificato in un archivio certificati di sistema Windows e ne restituisce i metadati; ogni voce contiene i nomi Subject e Issuer, il numero di serie (esadecimale maiuscolo, MSB prima), la finestra di validità NotBefore/NotAfter, un flag HasPrivateKey (richiesto per la firma), un flag Qualified (vero quando il certificato contiene l'estensione eIDAS QCStatements, OID 0.4.0.1862.1.7, rilevata tramite un decoder DER integrato) e un CertHandle (il PCCERT_CONTEXT non elaborato)

CertHandle è valido solo per la durata della chiamata; i chiamanti che desiderano conservare un handle per una firma successiva devono duplicarlo tramite CertDuplicateCertificateContext e quindi passarlo a SetSignProcessCertFromStoreByHandle

Syntax

Delphi

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

Parameters

StoreNameIl nome del Windows system store ("MY", "Root", "CA", ...)
UseMachineStoreTrue for CERT_SYSTEM_STORE_LOCAL_MACHINE, False for CERT_SYSTEM_STORE_CURRENT_USER
CertsArray allocato dal chiamante riempito con i metadati del certificato fino alla sua lunghezza

Return values

>= 0Il numero di certificati scritti in Certs (può essere inferiore alla dimensione dell'archivio se l'array è troppo piccolo)