CryptVerifyTimeStampSignature-Funktion (wincrypt.h)
Die Funktion CryptVerifyTimeStampSignature überprüft die Zeitstempelsignatur für ein angegebenes Bytearray.
Syntax
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
);
Parameter
[in] pbTSContentInfo
Ein Zeiger auf einen Puffer, der Zeitstempelinhalt enthält.
cbTSContentInfo
Die Größe des Puffers in Byte, auf den der pbTSContentInfo-Parameter verweist.
[in, optional] pbData
Ein Zeiger auf ein Bytearray, auf dem die Zeitstempelsignatur überprüft werden soll.
cbData
Die Größe des Arrays in Bytes, auf das der pbData-Parameter verweist.
[in, optional] hAdditionalStore
Das Handle eines zusätzlichen Speichers zum Suchen nach unterstützenden TSA-Signaturzertifikaten (Time Stamping Authority) und Zertifikatvertrauenslisten (Certificate Trust Lists , CTLs). Dieser Parameter kann NULL sein, wenn kein zusätzlicher Speicher durchsucht werden soll.
[out] ppTsContext
Ein Zeiger auf eine PCRYPT_TIMESTAMP_CONTEXT-Struktur . Wenn Sie die Verwendung des Kontexts abgeschlossen haben, müssen Sie ihn freigeben, indem Sie die CryptMemFree-Funktion aufrufen.
[out, optional] ppTsSigner
Ein Zeiger auf eine PCERT_CONTEXT , die das Zertifikat des Signierers empfängt. Wenn Sie die Verwendung dieser Struktur abgeschlossen haben, müssen Sie sie freigeben, indem Sie diesen Zeiger an die CertFreeCertificateContext-Funktion übergeben.
Legen Sie diesen Parameter auf NULL fest, wenn das Zertifikat des TSA-Signierers nicht benötigt wird.
[out, optional] phStore
Ein Zeiger auf ein Handle, das den zertifikatbasierten Speicher empfängt, der im CMS geöffnet ist, um nach unterstützenden Zertifikaten zu suchen.
Dieser Parameter kann NULL sein, wenn die TSA-unterstützenden Zertifikate nicht benötigt werden. Wenn Sie mit der Verwendung dieses Handles fertig sind, müssen Sie es freigeben, indem Sie es an die CertCloseStore-Funktion übergeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion TRUE zurück. Rufen Sie die GetLastError-Funktion auf, um erweiterte Fehlerinformationen zu erhalten.
Hinweise
Der Aufrufer sollte den pszTSAPolicyId-Member der CRYPT_TIMESTAMP_INFO-Struktur überprüfen, wenn er von der CryptRetrieveTimeStamp-Funktion zurückgegeben wird. Wenn in der Anforderung eine TSA-Richtlinie angegeben wurde und das ftTime-Element einen gültigen Wert enthält, sollte der Aufrufer eine Zertifikatkontextkette erstellen, mit der der ppTsSigner-Parameter aufgefüllt und die Vertrauensstellung überprüft werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 R2 [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | wincrypt.h |
| DLL | Crypt32.dll |