Funzione CryptHashCertificate2 (wincrypt.h)

La funzione CryptHashCertificate2 esegue l'hash di un blocco di dati usando un provider hash CNG.

Sintassi

BOOL CryptHashCertificate2(
  [in]      LPCWSTR    pwszCNGHashAlgid,
  [in]      DWORD      dwFlags,
            void       *pvReserved,
  [in]      const BYTE *pbEncoded,
  [in]      DWORD      cbEncoded,
  [out]     BYTE       *pbComputedHash,
  [in, out] DWORD      *pcbComputedHash
);

Parametri

[in] pwszCNGHashAlgid

Indirizzo di una stringa Unicode con terminazione Null contenente l'identificatore dell'algoritmo hash CNG da usare per eseguire l'hashing del certificato. Può trattarsi di uno degli identificatori dell'algoritmo CNG che rappresenta un algoritmo hash o qualsiasi altro identificatore di algoritmo hash registrato.

[in] dwFlags

Set di flag che modificano il comportamento di questa funzione. Non sono definiti flag per questa funzione.

pvReserved

Riservato per uso futuro e deve essere NULL.

[in] pbEncoded

Indirizzo di una matrice di byte di cui eseguire l'hashing. Il parametro cbEncoded contiene le dimensioni di questa matrice.

[in] cbEncoded

Numero di elementi nella matrice pbEncoded .

[out] pbComputedHash

Indirizzo di un buffer che riceve l'hash calcolato. La variabile a cui punta il parametro pcbComputedHash contiene le dimensioni di questo buffer.

[in, out] pcbComputedHash

L'indirizzo di una variabile DWORD che, nella voce, contiene le dimensioni, in byte, del buffer pbComputedHash . Al termine della restituzione di questa funzione, questa variabile contiene il numero di byte copiati nel buffer pbComputedHash .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero (TRUE).

Se la funzione non riesce, restituisce zero (FALSE). Per informazioni sugli errori estesi, chiamare GetLastError. Alcuni dei possibili codici di errore sono identificati negli argomenti seguenti.

BCryptOpenAlgorithmProvider
BCryptCreateHash
BCryptGetProperty
BCryptHashData
BCryptFinishHash

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [app desktop | App UWP]
Server minimo supportato Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Crypt32.lib
DLL Crypt32.dll

Vedi anche

Funzioni Gestione dati