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 de 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 pesquisar o suporte a 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ê deverá 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ê deverá liberá-la passando esse ponteiro para a função CertFreeCertificateContext .
Defina esse parâmetro como NULL se o certificado do signatário 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 pesquisar 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 .
Retornar valor
Se a função for bem-sucedida, a função retornará TRUE. Para obter informações de erro estendidas, chame a função GetLastError .
Comentários
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.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 7 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2008 R2 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | wincrypt.h |
| DLL | Crypt32.dll |