CryptRetrieveTimeStamp, fonction (wincrypt.h)

La fonction CryptRetrieveTimeStamp encode une demande d’horodatage et récupère le jeton d’horodatage à partir d’un emplacement spécifié par une URL vers une autorité d’horodatage (TSA).

Syntaxe

BOOL CryptRetrieveTimeStamp(
  [in]            LPCWSTR                    wszUrl,
                  DWORD                      dwRetrievalFlags,
                  DWORD                      dwTimeout,
  [in]            LPCSTR                     pszHashId,
  [in, optional]  const CRYPT_TIMESTAMP_PARA *pPara,
  [in]            const BYTE                 *pbData,
                  DWORD                      cbData,
  [out]           PCRYPT_TIMESTAMP_CONTEXT   *ppTsContext,
  [out, optional] PCCERT_CONTEXT             *ppTsSigner,
  [out, optional] HCERTSTORE                 *phStore
);

Paramètres

[in] wszUrl

Pointeur vers une chaîne de caractères large terminée par null qui contient l’URL du TSA auquel envoyer la requête.

dwRetrievalFlags

Ensemble d’indicateurs qui spécifient la façon dont l’horodatage est récupéré.

dwTimeout

Valeur DWORD qui spécifie le nombre maximal de millisecondes à attendre pour la récupération. Si ce paramètre est défini sur zéro, cette fonction n’expire pas.

[in] pszHashId

Pointeur vers une chaîne de caractères terminée par null qui contient l’identificateur d’objet de l’algorithme de hachage (OID).

[in, optional] pPara

Pointeur vers une structure CRYPT_TIMESTAMP_PARA qui contient des paramètres supplémentaires pour la requête.

[in] pbData

Pointeur vers un tableau d’octets à horodatage.

cbData

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

[out] ppTsContext

Pointeur vers une structure PCRYPT_TIMESTAMP_CONTEXT . Lorsque 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

Handle d’un magasin de certificats initialisé avec des certificats à partir de la réponse d’horodatage. Ce magasin peut être utilisé pour valider le certificat de signataire de la réponse d’horodatage.

Ce paramètre peut être NULL si les certificats de prise en charge DE TSA ne sont pas nécessaires. Une fois que vous avez terminé d’utiliser ce handle, relâchez-le en le transmettant à la fonction CertCloseStore .

Valeur retournée

Si la fonction ne parvient pas à récupérer, décoder et valider le contexte d’horodatage, elle retourne FALSE. Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError .

Spécifications

Voir aussi

CryptVerifyTimeStampSignature