Metodo ICertificates2::Find
[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 |
|
Vedi anche
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per