estructura CERT_REVOCATION_PARA (wincrypt.h)
La estructura CERT_REVOCATION_PARA se pasa en llamadas a la función CertVerifyRevocation para ayudar a encontrar el emisor del contexto que se va a comprobar. La estructura CERT_REVOCATION_PARA es un parámetro opcional en la función CertVerifyRevocation .
Sintaxis
typedef struct _CERT_REVOCATION_PARA {
DWORD cbSize;
PCCERT_CONTEXT pIssuerCert;
DWORD cCertStore;
HCERTSTORE *rgCertStore;
HCERTSTORE hCrlStore;
LPFILETIME pftTimeToUse;
DWORD dwUrlRetrievalTimeout;
BOOL fCheckFreshnessTime;
DWORD dwFreshnessTime;
LPFILETIME pftCurrentTime;
PCERT_REVOCATION_CRL_INFO pCrlInfo;
LPFILETIME pftCacheResync;
PCERT_REVOCATION_CHAIN_PARA pChainPara;
} CERT_REVOCATION_PARA, *PCERT_REVOCATION_PARA;
Miembros
cbSize
Tamaño, en bytes, de esta estructura.
pIssuerCert
Puntero a una estructura de CERT_CONTEXT que contiene el certificado del emisor de un certificado especificado en la matriz rgpvContext de la lista de parámetros CertVerifyRevocation .
cCertStore
Cuando se establece, contiene el número de elementos de la matriz rgCertStore . Establezca en cero si no proporciona una lista de identificadores de almacén en el parámetro rgCertStore .
rgCertStore
Matriz de identificadores de almacén de certificados . Especifica un conjunto de almacenes en los que se buscan certificados de emisor. Si no se establece rgCertStore , se buscan los almacenes predeterminados.
hCrlStore
Identificador de almacén opcional. Cuando se especifica, un controlador que usa listas de revocación de certificados (CRL) puede buscar en este almacén las CRL.
pftTimeToUse
Puntero a una versión FILETIME de hora UTC. Cuando se especifica, el controlador debe determinar, si es posible, el estado de revocación en relación con el tiempo especificado. Si NULL o el controlador no pueden determinar el estado relativo al valor pftTimeToUse , el estado de revocación se puede determinar independientemente del tiempo o relativo a la hora actual.
dwUrlRetrievalTimeout
Este miembro solo se define si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS . Tiempo de espera, en milisegundos, que el controlador de revocación esperará al intentar recuperar información de revocación. Si se establece en cero, se usa el tiempo de espera predeterminado del controlador de revocación. Si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS , este miembro debe establecerse en cero si no se usa.
fCheckFreshnessTime
Este miembro solo se define si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS . Si es TRUE, se intenta recuperar una nueva CRL si la fecha de emisión de la CRL es menor o igual que la hora actual menos dwFreshnessTime. Si no se establece esta marca, se usa la hora NextUpdate de la CRL. Si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS , este miembro debe establecerse en FALSE si no se usa.
dwFreshnessTime
Este miembro solo se define si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS . El tiempo, en segundos, se usa para determinar si se intentará recuperar una nueva CRL. Si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS , este miembro debe establecerse en cero si no se usa.
pftCurrentTime
Este miembro solo se define si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS . Puntero a una estructura FILETIME que se usa en la comprobación de tiempo de actualización. Si el valor de este puntero es NULL, el controlador de revocación usa la hora actual. Si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS , este miembro debe establecerse en NULL si no se usa.
pCrlInfo
Este miembro solo se define si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS . Este miembro contiene un puntero a una estructura PCERT_REVOCATION_CRL_INFO que contiene información de contexto CRL. La información crL solo es aplicable al último contexto comprobado. Para acceder a la información de esta CRL, llame a la función CertVerifyRevocation con cContext establecido en 1. Si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS , el miembro debe establecerse en NULL si no se usa.
pftCacheResync
Este miembro solo se define si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS . Este miembro contiene un puntero a una estructura FILETIME que especifica el uso de información almacenada en caché. Cualquier información almacenada en caché antes del tiempo especificado se considera no válida y se recupera información nueva. Si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS , este miembro debe establecerse en NULL si no se usa.
Windows Server 2003 y Windows XP: Este miembro no se usa.
pChainPara
Este miembro solo se define si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS . Este miembro contiene un puntero a una estructura de CERT_REVOCATION_CHAIN_PARA que contiene parámetros usados para crear una cadena para un certificado de firmante OCSP independiente. Si se define CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS , este miembro debe establecerse en NULL si no se usa.
Windows Vista, Windows Server 2003 y Windows XP: Este miembro no se usa en los sistemas enumerados. El miembro está disponible a partir de Windows Vista con SP1.
Comentarios
La estructura CERT_REVOCATION_PARA proporciona información adicional que la función CertVerifyRevocation puede usar para determinar el emisor de contexto.
Si la aplicación debe comprobar la actualización de la CRL o volver a sincronizar la caché crL, puede proporcionar miembros de estructura adicionales para ayudar a la función CertVerifyRevocation con esto. Para incluir los miembros de estructura adicionales, defina la constante CERT_REVOCATION_PARA_HAS_EXTRA_FIELDS en la aplicación antes de incluir Wincrypt.h.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | wincrypt.h |