Função CryptVerifyTimeStampSignature (wincrypt.h)

A função CryptVerifyTimeStampSignature valida a assinatura de carimbo de data/hora em uma matriz de bytes especificada.

Sintaxe

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

Um ponteiro para um buffer que contém o conteúdo do carimbo de data/hora.

cbTSContentInfo

O tamanho, em bytes, do buffer apontado pelo parâmetro pbTSContentInfo .

[in, optional] pbData

Um ponteiro para uma matriz de bytes na qual validar a assinatura do carimbo de data/hora.

cbData

O tamanho, em bytes, da matriz apontada pelo parâmetro pbData .

[in, optional] hAdditionalStore

O identificador de um repositório adicional para procurar certificados de assinatura da TSA (Autoridade de Carimbo de Data/Hora) e ctls (listas de confiança de certificado ). Esse parâmetro poderá ser NULL se nenhum repositório adicional for pesquisado.

[out] ppTsContext

Um ponteiro para uma estrutura PCRYPT_TIMESTAMP_CONTEXT . Quando terminar de usar o contexto, você deve liberá-lo chamando a função CryptMemFree .

[out, optional] ppTsSigner

Um ponteiro para um PCERT_CONTEXT que recebe o certificado do signatário. Quando terminar de usar essa estrutura, você deve liberá-la passando esse ponteiro para a função CertFreeCertificateContext .

Defina esse parâmetro como NULL se o certificado do signatário da TSA não for necessário.

[out, optional] phStore

Um ponteiro para um identificador que recebe o repositório de certificados aberto no CMS para procurar certificados de suporte.

Esse parâmetro poderá ser NULL se os certificados de suporte da TSA não forem necessários. Quando terminar de usar esse identificador, você deverá liberá-lo passando-o para a função CertCloseStore .

Valor de retorno

Se a função for bem-sucedida, a função retornará TRUE. Para obter informações de erro estendidas, chame a função GetLastError .

Observações

O chamador deve validar o membro pszTSAPolicyId da estrutura CRYPT_TIMESTAMP_INFO quando ele é retornado pela função CryptRetrieveTimeStamp . Se uma política TSA tiver sido especificada na solicitação e o membro ftTime contiver um valor válido, o chamador deverá criar uma cadeia de contexto de certificado com a qual preencher o parâmetro ppTsSigner e validar a confiança.

Requirements

Consulte também

CryptRetrieveTimeStamp