Metodo ICertificates2::Find

Articolo
06/12/2023

[CAPICOM è un componente solo a 32 bit disponibile per l'uso nei sistemi operativi seguenti: Windows Server 2008, Windows Vista e Windows XP. Usare invece la classe X509Certificate2Collection nello spazio dei nomi System.Security.Cryptography.X509Certificates .

Il metodo Find restituisce un oggetto Certificates che contiene tutti i certificati che corrispondono ai criteri di ricerca specificati. Questo metodo è stato introdotto in CAPICOM 2.0.

Sintassi

Certificates.Find( _
  ByVal FindType, _
  [ ByVal varCriteria ], _
  [ ByVal bFindValidOnly ] _
)

Parametri

FindType [in]

Valore dell'enumerazione CAPICOM_CERTIFICATE_FIND_TYPE che specifica il tipo di criteri corrispondenti specificati nel parametro varCriteria . Nella tabella seguente sono illustrati i possibili valori.

Valore	Significato
CAPICOM_CERTIFICATE_FIND_SHA1_HASH	Restituisce i certificati con un hash SHA1 corrispondente all'hash SHA1 specificato nel parametro varCriteria .
CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME	Restituisce certificati il cui nome soggetto corrisponde esattamente o parzialmente al nome soggetto specificato nel parametro varCriteria . Questa chiamata esegue la ricerca solo nel campo del nome soggetto.
CAPICOM_CERTIFICATE_FIND_ISSUER_NAME	Restituisce certificati il cui nome dell'autorità emittente corrisponde esattamente o parzialmente al nome dell'autorità emittente specificato nel parametro varCriteria . Questa chiamata esegue la ricerca solo nel campo del nome dell'autorità emittente.
CAPICOM_CERTIFICATE_FIND_ROOT_NAME	Restituisce certificati il cui nome del soggetto radice corrisponde esattamente o parzialmente al nome del soggetto radice specificato nel parametro varCriteria . Questa chiamata crea una catena. Questa chiamata esegue la ricerca nel campo del nome soggetto del certificato radice.
CAPICOM_CERTIFICATE_FIND_TEMPLATE_NAME	Restituisce i certificati il cui nome del modello corrisponde al nome del modello specificato nel parametro varCriteria .
CAPICOM_CERTIFICATE_FIND_EXTENSION	Restituisce i certificati con un'estensione corrispondente all'estensione specificata nel parametro varCriteria .
CAPICOM_CERTIFICATE_FIND_EXTENDED_PROPERTY	Restituisce i certificati nell'archivio che contengono in modo esplicito una proprietà estesa con il valore specificato nel parametro varCriteria .
CAPICOM_CERTIFICATE_FIND_APPLICATION_POLICY	Restituisce i certificati nell'archivio che dispongono di un'estensione avanzata per l'utilizzo delle chiavi, dell'estensione dei criteri dell'applicazione o di una proprietà estesa specificata nel parametro varCriteria .
CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY	Restituisce i certificati che contengono l'OID dei criteri nell'estensione Criteri di certificato specificata nel parametro varCriteria .
CAPICOM_CERTIFICATE_FIND_TIME_VALID	Restituisce i certificati il cui tempo è valido.
CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID	Restituisce i certificati il cui tempo non è ancora valido.
CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED	Restituisce i certificati il cui tempo è scaduto.
CAPICOM_CERTIFICATE_FIND_KEY_USAGE	Restituisce i certificati contenenti l'utilizzo delle chiavi nell'estensione KeyUsage specificata nel parametro varCriteria . Se l'estensione KeyUsage non è presente, si presuppone che tutti gli utilizzi delle chiavi non siano disponibili.

varCriteria [in, facoltativo]

Variante che contiene i criteri di ricerca. Questi dati devono corrispondere al tipo di dati specificato nel parametro FindType . Se il valore del parametro FindType è CAPICOM_CERTIFICATE_FIND_TIME_VALID, CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID o CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED e non si passa un valore in questo parametro, verrà utilizzato l'ora corrente. Per esempi di ogni tipo di dati, vedere Osservazioni. Il valore predefinito è 0.

bFindValidOnly [in, facoltativo]

Valore booleano che indica se vengono restituiti solo certificati validi. Il valore predefinito è false; ciò indica che vengono restituiti tutti i certificati che corrispondono ai criteri di ricerca.

Se true, la ricerca non restituirà i tipi di certificati seguenti:

Certificati il cui tempo è scaduto o non è ancora valido.
Certificati non concatenati correttamente.
Certificati con problemi di firma.
Certificati revocati.

Valore restituito

Oggetto Certificates contenente i risultati della ricerca.

CAPICOM 2.1: L'oggetto Certificates restituito contiene riferimenti ai certificati nell'insieme in cui è stata eseguita la ricerca. Tutte le modifiche apportate ai certificati nell'oggetto Certificates restituito vengono riflesse in tale raccolta.

CAPICOM 2.0, CAPICOM 2.0.0.1, CAPICOM 2.0.0.2 e CAPICOM 2.0.0.3: L'oggetto Certificates restituito contiene copie dei certificati nell'insieme in cui è stata eseguita la ricerca. Le modifiche apportate ai certificati nell'oggetto Certificates restituito non vengono riflesse nell'insieme.

Commenti

Negli esempi seguenti vengono illustrati i possibili criteri di ricerca per i diversi tipi di criteri di ricerca.

Parametro FindType	parametro varCriteria
CAPICOM_CERTIFICATE_FIND_SHA1_HASH	33F362434B577F844BB7226BE36F7D72EF9D9393
CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME	"NameOfPerson"
CAPICOM_CERTIFICATE_FIND_ISSUER_NAME	"VeriSign"
CAPICOM_CERTIFICATE_FIND_ROOT_NAME	"Autorità radice Microsoft"
CAPICOM_CERTIFICATE_FIND_TEMPLATE_NAME	"AutoEnrollEFS" 1.3.6.1.4.1.311.21.8.3692315854.1256661383.1690418588.4201632533.1741915387.2177932052
CAPICOM_CERTIFICATE_FIND_EXTENSION	"2.5.29.31" CAPICOM_OID_KEY_USAGE_EXTENSION "Lista di distribuzione CRL"
CAPICOM_CERTIFICATE_FIND_EXTENDED_PROPERTY	CAPICOM_PROPID_KEY_PROV_INFO
CAPICOM_CERTIFICATE_FIND_APPLICATION_POLICY	"1.3.6.1.5.5.7.3.3" "1.3.6.1.5.5.7.3.4" CAPICOM_OID_SERVER_AUTH_EKU "Firma del codice"
CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY	"1.3.6.1.5.5.7.3.4.3.5" "Corporate High Assurance"
CAPICOM_CERTIFICATE_FIND_TIME_VALID	#04/15/2002, 18:00 #
CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID	#04/15/2002, 18:00 #
CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED	#04/15/2002, 18:00 #
CAPICOM_CERTIFICATE_FIND_KEY_USAGE	CAPICOM_ENCIPHER_ONLY_KEY_USAGE

Requisiti

Requisito	Valore
Fine del supporto client	Windows Vista
Fine del supporto server	Windows Server 2008
Componente ridistribuibile	CAPICOM 2.0 o versione successiva in Windows Server 2003 e Windows XP
DLL	Capicom.dll

Vedi anche

Certificati
CAPICOM_OID

Condividi tramite