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 參數並驗證信任。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | wincrypt.h |
Dll | Crypt32.dll |