CryptVerifyTimeStampSignature 函式 (wincrypt.h)

CryptVerifyTimeStampSignature 函式會驗證指定位元組數位上的時間戳簽章。

語法

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
);

參數

[in] pbTSContentInfo

緩衝區的指標，其中包含時間戳內容。

cbTSContentInfo

pbTSContentInfo 參數所指向緩衝區的大小，以位元組為單位。

[in, optional] pbData

要驗證時間戳簽章的位元組陣列指標。

cbData

pbData 參數所指向數位的大小，以位元組為單位。

[in, optional] hAdditionalStore

要搜尋支援時間戳授權單位 (TSA) 簽署憑證和 憑證信任清單 (CTL) 的其他存放區句柄。 如果未搜尋其他存放區，這個參數可以是 NULL 。

[out] ppTsContext

PCRYPT_TIMESTAMP_CONTEXT 結構的指標。 當您完成使用內容時，必須呼叫 CryptMemFree 函式來釋放它。

[out, optional] ppTsSigner

接收簽署者憑證 之PCERT_CONTEXT 的指標。 當您完成使用此結構時，必須將此指標傳遞至 CertFreeCertificateContext 函式來釋放它。

如果不需要 TSA 簽署者的憑證，請將此參數設定為 NULL 。

[out, optional] phStore

句柄的指標，接收在CMS上開啟的證書存儲，以搜尋支援的憑證。

如果不需要 TSA 支援憑證，此參數可以是 NULL 。 當您完成使用此句柄時，必須將它傳遞給 CertCloseStore 函式來釋放它。

傳回值

如果函式成功，函式會傳回 TRUE。 如需擴充的錯誤資訊，請呼叫 GetLastError 函 式。

備註

呼叫端應該在 CryptRetrieveTimeStamp 函式傳回時驗證CRYPT_TIMESTAMP_INFO結構的 pszTSAPolicyId 成員。 如果在要求中指定 TSA 原則， 而 ftTime 成員包含有效值，呼叫端應該建置憑證內容鏈結，以填入 ppTsSigner 參數並驗證信任。

規格需求

另請參閱

CryptRetrieveTimeStamp