Eventos
19 nov, 23 - 21 nov, 23
Obtenga la ventaja competitiva que necesita con soluciones eficaces de inteligencia artificial y nube al asistir a Microsoft Ignite online.
Regístrese ahoraEste explorador ya no se admite.
Actualice a Microsoft Edge para aprovechar las características y actualizaciones de seguridad más recientes, y disponer de soporte técnico.
[CAPICOM es un componente solo de 32 bits que está disponible para su uso en los siguientes sistemas operativos: Windows Server 2008, Windows Vista y Windows XP. En su lugar, use la clase X509Certificate2Collection en el espacio de nombres System.Security.Cryptography.X509Certificates .
El método Find devuelve un objeto Certificates que contiene todos los certificados que coinciden con los criterios de búsqueda especificados. Este método se introdujo en CAPICOM 2.0.
Certificates.Find( _
ByVal FindType, _
[ ByVal varCriteria ], _
[ ByVal bFindValidOnly ] _
)
FindType [in]
Valor de la enumeración CAPICOM_CERTIFICATE_FIND_TYPE que especifica el tipo de criterios de coincidencia proporcionados en el parámetro varCriteria . En la siguiente tabla se muestran los valores posibles.
Valor | Significado |
---|---|
|
Devuelve certificados con un hash SHA1 que coincide con el hash SHA1 especificado en el parámetro varCriteria . |
|
Devuelve certificados cuyo nombre de sujeto coincide exacta o parcialmente con el nombre del firmante especificado en el parámetro varCriteria . Esta llamada solo busca el campo de nombre del firmante. |
|
Devuelve certificados cuyo nombre del emisor coincide exacta o parcialmente con el nombre del emisor especificado en el parámetro varCriteria . Esta llamada solo busca el campo nombre del emisor. |
|
Devuelve certificados cuyo nombre de sujeto raíz coincide exacta o parcialmente con el nombre del firmante raíz especificado en el parámetro varCriteria . Esta llamada crea una cadena. Esta llamada busca en el campo de nombre del firmante del certificado raíz. |
|
Devuelve certificados cuyo nombre de plantilla coincide con el nombre de plantilla especificado en el parámetro varCriteria . |
|
Devuelve certificados que tienen una extensión que coincide con la extensión especificada en el parámetro varCriteria . |
|
Devuelve certificados en el almacén que contienen explícitamente una propiedad extendida con el valor especificado en el parámetro varCriteria . |
|
Devuelve certificados en el almacén que tienen una extensión de uso de clave mejorada, una extensión de directiva de aplicación o una propiedad extendida especificada en el parámetro varCriteria . |
|
Devuelve certificados que contienen el OID de directiva en la extensión de directiva de certificado especificada en el parámetro varCriteria . |
|
Devuelve certificados cuyo tiempo es válido. |
|
Devuelve certificados cuya hora aún no es válida. |
|
Devuelve certificados cuyo tiempo ha expirado. |
|
Devuelve certificados que contienen usos de clave en la extensión KeyUsage especificada en el parámetro varCriteria . Si la extensión KeyUsage no está presente, se supone que todos los usos de claves no están disponibles. |
varCriteria [in, opcional]
Variante que contiene los criterios de búsqueda. Estos datos deben coincidir con el tipo de datos especificados en el parámetro FindType . Si el valor del parámetro FindType es CAPICOM_CERTIFICATE_FIND_TIME_VALID, CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID o CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED y no se pasa un valor a este parámetro, se supone la hora actual. Para obtener ejemplos de cada tipo de datos, vea Comentarios. El valor predeterminado es 0.
bFindValidOnly [in, opcional]
Valor booleano que indica si solo se devuelven certificados válidos. El valor predeterminado es false; esto indica que se devuelven todos los certificados que coinciden con los criterios de búsqueda.
Si es true, la búsqueda no devolverá los siguientes tipos de certificados:
Objeto Certificates que contiene los resultados de la búsqueda.
CAPICOM 2.1: El objeto Certificates que se devuelve contiene referencias a los certificados de la colección en la que se realizó la búsqueda. Los cambios realizados en los certificados del objeto Certificates devuelto se reflejan en esa colección.
CAPICOM 2.0, CAPICOM 2.0.0.1, CAPICOM 2.0.0.2 y CAPICOM 2.0.0.3: El objeto Certificates que se devuelve contiene copias de los certificados de la colección en la que se realizó la búsqueda. Los cambios realizados en los certificados del objeto Certificates devuelto no se reflejan en esa colección.
En los ejemplos siguientes se muestran posibles criterios de búsqueda para los distintos tipos de criterios de búsqueda.
Parámetro FindType | VarCriteria , parámetro |
---|---|
CAPICOM_CERTIFICATE_FIND_SHA1_HASH | 33F362434B577F844BB7226BE36F7D72EF9D939393 |
CAPICOM_CERTIFICATE_FIND_SUBJECT_NAME | "NameOfPerson" |
CAPICOM_CERTIFICATE_FIND_ISSUER_NAME | "VeriSign" |
CAPICOM_CERTIFICATE_FIND_ROOT_NAME | "Entidad raíz de 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 de distribución de 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 de código" |
CAPICOM_CERTIFICATE_FIND_CERTIFICATE_POLICY | "1.3.6.1.5.5.7.3.4.3.5" "Garantía alta corporativa" |
CAPICOM_CERTIFICATE_FIND_TIME_VALID | #15/04/2002, 6:00 p. m. # |
CAPICOM_CERTIFICATE_FIND_TIME_NOT_YET_VALID | #15/04/2002, 6:00 p. m. # |
CAPICOM_CERTIFICATE_FIND_TIME_EXPIRED | #15/04/2002, 6:00 p. m. # |
CAPICOM_CERTIFICATE_FIND_KEY_USAGE | CAPICOM_ENCIPHER_ONLY_KEY_USAGE |
Requisito | Value |
---|---|
Fin de compatibilidad de cliente |
Windows Vista |
Fin de compatibilidad de servidor |
Windows Server 2008 |
Redistribuible |
CAPICOM 2.0 o posterior en Windows Server 2003 y Windows XP |
Archivo DLL |
|
Eventos
19 nov, 23 - 21 nov, 23
Obtenga la ventaja competitiva que necesita con soluciones eficaces de inteligencia artificial y nube al asistir a Microsoft Ignite online.
Regístrese ahora