CryptVerifyTimeStampSignature-Funktion (wincrypt.h)

Die CryptVerifyTimeStampSignature-Funktion überprüft die Zeitstempelsignatur auf einem angegebenen 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
);

Die Parameter

[in] pbTSContentInfo

Ein Zeiger auf einen Puffer, der Zeitstempelinhalt enthält.

cbTSContentInfo

Die Größe des Puffers in Bytes, auf den der PbTSContentInfo-Parameter verweist.

[in, optional] pbData

Ein Zeiger auf ein Bytearray, auf dem die Signatur des Zeitstempels ü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 zur Suche nach unterstützenden TSA-Signaturzertifikaten (Time Stamping Authority) und Zertifikatvertrauenslisten (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 den Kontext verwendet 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 diese Struktur verwendet haben, müssen Sie ihn 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 zertifikatsspeicher empfängt, der auf CMS geöffnet wurde, um nach unterstützenden Zertifikaten zu suchen.

Dieser Parameter kann NULL sein, wenn die TSA-Unterstützenden Zertifikate nicht benötigt werden. Wenn Sie dieses Handle verwendet haben, müssen Sie es freigeben, indem Sie es an die CertCloseStore-Funktion übergeben.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion WAHR zurück. Rufen Sie für erweiterte Fehlerinformationen die GetLastError-Funktion auf.

Bemerkungen

Der Aufrufer sollte das pszTSAPolicyId-Element der CRYPT_TIMESTAMP_INFO Struktur überprüfen, wenn es von der CryptRetrieveTimeStamp-Funktion zurückgegeben wird. Wenn eine TSA-Richtlinie in der Anforderung angegeben wurde und der ftTime-Member 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 soll.

Anforderungen

Siehe auch

CryptRetrieveTimeStamp