Funzione CryptRetrieveTimeStamp (wincrypt.h)

Articolo
08/27/2023

La funzione CryptRetrieveTimeStamp codifica una richiesta di timestamp e recupera il token di timestamp da una posizione specificata da un URL a un'autorità di timestamp (TSA).

Sintassi

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

Parametri

[in] wszUrl

Puntatore a una stringa di caratteri wide con terminazione null contenente l'URL del TSA a cui inviare la richiesta.

dwRetrievalFlags

Set di flag che specificano il modo in cui viene recuperato il timestamp.

Valore	Significato
TIMESTAMP_DONT_HASH_DATA 0x00000001	Inibire il calcolo hash sulla matrice di byte a cui punta il parametro pbData .
TIMESTAMP_VERIFY_CONTEXT_SIGNATURE 0x00000020	Applicare la convalida della firma nel timestamp recuperato. Nota Il flag di TIMESTAMP_VERIFY_CONTEXT_SIGNATURE è valido solo se il membro fRequestCerts del CRYPT_TIMESTAMP_PARA puntato dal parametro pPara è impostato su TRUE.
TIMESTAMP_NO_AUTH_RETRIEVAL 0x00020000	Impostare questo flag per impedire la gestione automatica dell'autenticazione.

dwTimeout

Valore DWORD che specifica il numero massimo di millisecondi da attendere il recupero. Se questo parametro è impostato su zero, questa funzione non timeout.

[in] pszHashId

Puntatore a una stringa di caratteri con terminazione null contenente l'identificatore dell'oggetto dell'algoritmo hash (OID).

[in, optional] pPara

Puntatore a una struttura CRYPT_TIMESTAMP_PARA che contiene parametri aggiuntivi per la richiesta.

[in] pbData

Puntatore a una matrice di byte da impostare come timestamp.

cbData

Dimensioni, in byte, della matrice a cui punta il parametro pbData .

[out] ppTsContext

Puntatore a una struttura PCRYPT_TIMESTAMP_CONTEXT . Al termine dell'uso del contesto, è necessario liberarlo chiamando la funzione CryptMemFree .

[out, optional] ppTsSigner

Puntatore a un PCERT_CONTEXT che riceve il certificato del firmatario. Al termine dell'uso di questa struttura, è necessario liberarlo passando questo puntatore alla funzione CertFreeCertificateContext .

Impostare questo parametro su NULL se il certificato del firmatario TSA non è necessario.

[out, optional] phStore

Handle di un archivio certificati inizializzato con certificati dalla risposta timestamp. Questo archivio può essere usato per convalidare il certificato di firma della risposta timestamp.

Questo parametro può essere NULL se i certificati di supporto TSA non sono necessari. Al termine dell'uso di questo handle, rilasciarlo passandolo alla funzione CertCloseStore .

Valore restituito

Se la funzione non è in grado di recuperare, decodificare e convalidare il contesto del timestamp, restituisce FALSE. Per informazioni sull'errore estese, chiamare la funzione GetLastError .

Requisiti


Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincrypt.h
DLL	Crypt32.dll

Vedi anche

CryptVerifyTimeStampSignature

Condividi tramite