CryptVerifyTimeStampSignature-Funktion (wincrypt.h)

  • Artikel

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

Weitere Informationen

CryptRetrieveTimeStamp