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

Consulte también

CryptRetrieveTimeStamp