Condividi tramite


Funzione CryptHashData (wincrypt.h)

Importante Questa API è deprecata. Il software nuovo e esistente deve iniziare a usare le API di nuova generazione di crittografia. Microsoft può rimuovere questa API nelle versioni future.
 
La funzione CryptHashData aggiunge dati a un oggetto hash specificato. Questa funzione e CryptHashSessionKey possono essere chiamate più volte per calcolare l'hash di flussi di dati lunghi o discontinui.

Prima di chiamare questa funzione, CryptCreateHash deve essere chiamato per creare un handle di un oggetto hash.

Sintassi

BOOL CryptHashData(
  [in] HCRYPTHASH hHash,
  [in] const BYTE *pbData,
  [in] DWORD      dwDataLen,
  [in] DWORD      dwFlags
);

Parametri

[in] hHash

Handle dell'oggetto hash.

[in] pbData

Puntatore a un buffer che contiene i dati da aggiungere all'oggetto hash.

[in] dwDataLen

Numero di byte di dati da aggiungere. Questo deve essere zero se il flag di CRYPT_USERDATA è impostato.

[in] dwFlags

I valori di flag seguenti sono definiti.

Valore Significato
CRYPT_OWF_REPL_LM_HASH
0x00000001
Questo flag non viene usato.
CRYPT_USERDATA
1 (0x1)
Tutti i provider di crittografia Microsoft ignorano questo parametro. Per qualsiasi CSP che non ignora questo parametro, se questo flag è impostato, il CSP richiede all'utente di immettere direttamente i dati. Questi dati vengono aggiunti all'hash. L'applicazione non è consentita l'accesso ai dati. Questo flag può essere usato per consentire all'utente di immettere un PIN nel sistema.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni sull'errore estese, chiamare GetLastError.

I codici di errore preceduti da "NTE" vengono generati dal particolare CSP usato. Alcuni codici di errore possibili seguono.

Codice restituito Descrizione
ERROR_INVALID_HANDLE
Uno dei parametri specifica un handle non valido.
ERROR_INVALID_PARAMETER
Uno dei parametri contiene un valore non valido. Questo è più spesso un puntatore che non è valido.
NTE_BAD_ALGID
L'handle hHash specifica un algoritmo che questo CSP non supporta.
NTE_BAD_FLAGS
Il parametro dwFlags contiene un valore non valido.
NTE_BAD_HASH
L'oggetto hash specificato dal parametro hHash non è valido.
NTE_BAD_HASH_STATE
È stato eseguito un tentativo di aggiungere dati a un oggetto hash già contrassegnato come "completato".
NTE_BAD_KEY
Viene usato un algoritmo hash con chiave, ma la chiave di sessione non è più valida. Questo errore viene generato se la chiave di sessione viene eliminata prima del completamento dell'operazione di hashing.
NTE_BAD_LEN
Il CSP non ignora il flag CRYPT_USERDATA, il flag è impostato e il parametro dwDataLen ha un valore diverso da zero.
NTE_BAD_UID
Impossibile trovare il contesto CSP specificato quando l'oggetto hash è stato creato.
NTE_FAIL
La funzione non è riuscita in modo imprevisto.
NTE_NO_MEMORY
Il provider di servizi di rete ha esaurito la memoria durante l'operazione.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione wincrypt.h
Libreria Advapi32.lib
DLL Advapi32.dll

Vedi anche

CryptCreateHash

CryptHashSessionKey

CryptSignHash

Funzioni hash e firma digitale