Función CertVerifyRevocation (wincrypt.h)
La función CertVerifyRevocation comprueba el estado de revocación de los certificados contenidos en la matriz rgpvContext . Si se encuentra un certificado en la lista que se va a revocar, no se realiza ninguna comprobación adicional. Esta matriz puede ser una cadena de certificados que se propagan hacia arriba desde una entidad final a la entidad raíz, pero esta naturaleza de la lista de certificados no es necesaria ni se supone.
Sintaxis
BOOL CertVerifyRevocation(
[in] DWORD dwEncodingType,
[in] DWORD dwRevType,
[in] DWORD cContext,
[in] PVOID [] rgpvContext,
[in] DWORD dwFlags,
[in, optional] PCERT_REVOCATION_PARA pRevPara,
[in, out] PCERT_REVOCATION_STATUS pRevStatus
);
Parámetros
[in] dwEncodingType
Especifica el tipo de codificación utilizado. Actualmente, solo se usan X509_ASN_ENCODING y PKCS_7_ASN_ENCODING; sin embargo, en el futuro se pueden agregar tipos de codificación adicionales. Para cualquier tipo de codificación actual, use X509_ASN_ENCODING | PKCS_7_ASN_ENCODING.
[in] dwRevType
Indica el tipo de la estructura de contexto pasada en rgpvContext. Actualmente solo CERT_CONTEXT_REVOCATION_TYPE, se define la revocación de certificados.
[in] cContext
Recuento de elementos de la matriz rgpvContext .
[in] rgpvContext
Cuando dwRevType es CERT_CONTEXT_REVOCATION_TYPE, rgpvContext es una matriz de punteros a CERT_CONTEXT estructuras. Estos contextos deben contener información suficiente para permitir que los archivos DLL de revocación instalables o registrados encuentren el servidor de revocación. Esta información normalmente se transmitiría en una extensión como la extensión CRLDistributionsPoints definida por el Grupo de tareas de ingeniería de Internet (IETF) en la parte 1 de PKIX.
Para mejorar la eficacia, cuantos más contextos se pasen a la vez, mejor.
[in] dwFlags
Indica cualquier necesidad de procesamiento especial. Este parámetro puede ser una de las marcas siguientes.
| Valor | Significado |
|---|---|
|
La comprobación de la cadena de certificados se realiza suponiendo que cada certificado excepto el primer certificado sea el emisor del certificado que lo precede. Si dwRevType no es CERT_CONTEXT_REVOCATION_TYPE, no se realiza ninguna suposición sobre el orden de los contextos. |
|
Impide que el controlador de revocación acceda a los recursos basados en red para la comprobación de revocación. |
|
Cuando se establece, dwUrlRetrievalTimeout es el tiempo de espera acumulado en todas las recuperaciones de conexión url. |
|
Cuando se establece, esta función solo usa el protocolo de estado de certificado en línea (OCSP) para la comprobación de revocación. Si el certificado no tiene direcciones URL de AIA de OCSP, el miembro dwError del parámetro pRevStatus se establece en CRYPT_E_NOT_IN_REVOCATION_DATABASE. |
[in, optional] pRevPara
Opcionalmente, establezca para ayudar a encontrar el emisor. Para obtener más información, consulte la estructura CERT_REVOCATION_PARA .
[in, out] pRevStatus
Solo es necesario establecer el miembro cbSize del CERT_REVOCATION_STATUS al que apunta pRevStatus antes de llamar a CertVerifyRevocation .
Si la función devuelve FALSE, los miembros de esta estructura contendrán información de estado de error. Para obtener más información, consulte CERT_REVOCATION_STATUS. Para obtener una descripción de cómo se actualiza pRevStatus cuando se encuentra un problema de comprobación de revocación, vea Comentarios.
Valor devuelto
Si la función comprueba correctamente todos los contextos y ninguno se ha revocado, la función devuelve TRUE. Si se produce un error en la función, devuelve FALSE y actualiza la estructura de CERT_REVOCATION_STATUS a la que apunta pRevStatus como se describe en CERT_REVOCATION_STATUS.
Cuando el controlador de revocación de cualquiera de los contextos devuelve FALSE debido a un error, el controlador establecerá el miembro dwError en la estructura a la que apunta pRevStatus para especificar qué error se encontró. GetLastError devuelve un código de error igual al error especificado en el miembro dwError de la estructura CERT_REVOCATION_STATUS . GetLastError puede ser uno de los valores siguientes.
| Valor | Descripción |
|---|---|
|
Una función de revocación instalada o registrada no pudo realizar una comprobación de revocación en el contexto. |
|
No se encontró ningún archivo DLL instalado o registrado que pudiera comprobar la revocación. |
|
No se encontró el contexto que se va a comprobar en la base de datos del servidor de revocación. |
|
No era posible conectarse al servidor de revocación. |
|
Se revocó el contexto. dwReason en pRevStatus contiene el motivo de la revocación. |
|
El contexto era bueno. |
|
cbSize en pRevStatus es menor que sizeof(CERT_REVOCATION_STATUS). Tenga en cuenta que dwError en pRevStatus no se actualiza para este error. |
Comentarios
En el ejemplo siguiente se muestra cómo se actualiza pRevStatus cuando se encuentra un problema de comprobación de revocación:
Tenga en cuenta el caso en el que cContext es cuatro:
Si CertVerifyRevocation puede comprobar que rgpvContext[0] y rgpvContext[1] no se revocan, pero no pueden comprobar rgpvContext[2], el miembro pRevStatusdwIndex está establecido en dos, lo que indica que el contexto en el índice dos tiene el problema, el miembro dwError de pRevStatus se establece en CRYPT_E_NO_REVOCATION_CHECK y se devuelve FALSE .
Si se encuentra revocado rgpvContext[2], el miembro dwIndex de pRevStatus se establece en dos y el miembro dwError de pRevStatus se establece en CRYPT_E_REVOKED, dwReason se actualiza y se devuelve FALSE .
En cualquier caso, se comprueba que rgpvContext[0] y rgpvContext[1] no se revoquen, rgpvContext[2] es el último índice de matriz comprobado y rgpvContext[3] no se ha comprobado en absoluto.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wincrypt.h |
| Library | Crypt32.lib |
| Archivo DLL | Crypt32.dll |