Función CryptVerifyTimeStampSignature (wincrypt.h)
La función CryptVerifyTimeStampSignature valida la firma de marca de tiempo en una matriz especificada de bytes.
Sintaxis
BOOL CryptVerifyTimeStampSignature(
[in] const BYTE *pbTSContentInfo,
DWORD cbTSContentInfo,
[in, optional] const BYTE *pbData,
DWORD cbData,
[in, optional] HCERTSTORE hAdditionalStore,
[out] PCRYPT_TIMESTAMP_CONTEXT *ppTsContext,
[out, optional] PCCERT_CONTEXT *ppTsSigner,
[out, optional] HCERTSTORE *phStore
);
Parámetros
[in] pbTSContentInfo
Puntero a un búfer que contiene contenido de marca de tiempo.
cbTSContentInfo
Tamaño, en bytes, del búfer al que apunta el parámetro pbTSContentInfo .
[in, optional] pbData
Puntero a una matriz de bytes en la que se va a validar la firma de marca de tiempo.
cbData
Tamaño, en bytes, de la matriz a la que apunta el parámetro pbData .
[in, optional] hAdditionalStore
Identificador de un almacén adicional para buscar certificados de firma de entidad de marca de tiempo (TSA) auxiliares y listas de confianza de certificados (CTL). Este parámetro puede ser NULL si no se va a buscar ningún almacén adicional.
[out] ppTsContext
Puntero a una estructura de PCRYPT_TIMESTAMP_CONTEXT . Cuando haya terminado de usar el contexto, debe liberarlo llamando a la función CryptMemFree .
[out, optional] ppTsSigner
Puntero a un PCERT_CONTEXT que recibe el certificado del firmante. Cuando haya terminado de usar esta estructura, debe liberarlo pasando este puntero a la función CertFreeCertificateContext .
Establezca este parámetro en NULL si no se necesita el certificado del firmante de TSA.
[out, optional] phStore
Puntero a un identificador que recibe el almacén de certificados abierto en CMS para buscar certificados auxiliares.
Este parámetro puede ser NULL si no se necesitan los certificados auxiliares de TSA. Cuando haya terminado de usar este identificador, debe liberarlo pasando a la función CertCloseStore .
Valor devuelto
Si la función se ejecuta correctamente, la función devuelve TRUE. Para obtener información de error extendida, llame a la función GetLastError .
Comentarios
El autor de la llamada debe validar el miembro pszTSAPolicyId de la estructura CRYPT_TIMESTAMP_INFO cuando la función CryptRetrieveTimeStamp la devuelve. Si se especificó una directiva de TSA en la solicitud y el miembro ftTime contiene un valor válido, el llamador debe crear una cadena de contexto de certificado con la que rellenar el parámetro ppTsSigner y validar la confianza.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible | Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Plataforma de destino | Windows |
| Encabezado | wincrypt.h |
| Archivo DLL | Crypt32.dll |