Fonction CryptVerifyTimeStampSignature (wincrypt.h)

Article
03/13/2024

La fonction CryptVerifyTimeStampSignature valide la signature d’horodatage sur un tableau d’octets spécifié.

Syntaxe

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

Paramètres

[in] pbTSContentInfo

Pointeur vers une mémoire tampon qui contient du contenu d’horodatage.

cbTSContentInfo

Taille, en octets, de la mémoire tampon pointée vers le paramètre pbTSContentInfo .

[in, optional] pbData

Pointeur vers un tableau d’octets sur lequel valider la signature d’horodatage.

cbData

Taille, en octets, du tableau pointé vers le paramètre pbData .

[in, optional] hAdditionalStore

Handle d’un magasin supplémentaire pour rechercher les certificats de signature TSA (Time Stamping Authority) et les listes d’approbation de certificats (CTL) de prise en charge. Ce paramètre peut avoir la valeur NULL si aucune banque supplémentaire ne doit faire l’objet d’une recherche.

[out] ppTsContext

Pointeur vers une structure PCRYPT_TIMESTAMP_CONTEXT . Une fois que vous avez terminé d’utiliser le contexte, vous devez le libérer en appelant la fonction CryptMemFree .

[out, optional] ppTsSigner

Pointeur vers un PCERT_CONTEXT qui reçoit le certificat du signataire. Une fois cette structure terminée, vous devez la libérer en passant ce pointeur à la fonction CertFreeCertificateContext .

Définissez ce paramètre sur NULL si le certificat du signataire TSA n’est pas nécessaire.

[out, optional] phStore

Pointeur vers un handle qui reçoit le magasin de certificats ouvert sur CMS pour rechercher des certificats de prise en charge.

Ce paramètre peut avoir la valeur NULL si les certificats tsa prenant en charge ne sont pas nécessaires. Une fois que vous avez terminé d’utiliser ce handle, vous devez le libérer en le transmettant à la fonction CertCloseStore .

Valeur retournée

Si la fonction réussit, la fonction retourne TRUE. Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError .

Remarques

L’appelant doit valider le membre pszTSAPolicyId de la structure CRYPT_TIMESTAMP_INFO lorsqu’il est retourné par la fonction CryptRetrieveTimeStamp . Si une stratégie TSA a été spécifiée dans la requête et que le membre ftTime contient une valeur valide, l’appelant doit créer une chaîne de contexte de certificat avec laquelle remplir le paramètre ppTsSigner et valider l’approbation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	wincrypt.h
DLL	Crypt32.dll

Voir aussi

CryptRetrieveTimeStamp

Partager via