Funzione BCryptHashData (bcrypt.h)

La funzione BCryptHashData esegue un hash unidirezionale o codice di autenticazione del messaggio (MAC) in un buffer di dati.

Sintassi

NTSTATUS BCryptHashData(
  [in, out] BCRYPT_HASH_HANDLE hHash,
  [in]      PUCHAR             pbInput,
  [in]      ULONG              cbInput,
  [in]      ULONG              dwFlags
);

Parametri

[in, out] hHash

Handle dell'oggetto hash o MAC da utilizzare per eseguire l'operazione. Questo handle viene ottenuto chiamando la funzione BCryptCreateHash.

[in] pbInput

Puntatore a un buffer che contiene i dati da elaborare. Il parametro cbInput contiene il numero di byte in questo buffer. Questa funzione non modifica il contenuto di questo buffer.

[in] cbInput

Numero di byte nel buffer pbInput.

[in] dwFlags

Set di flag che modificano il comportamento di questa funzione. Non sono attualmente definiti flag, quindi questo parametro deve essere zero.

Valore restituito

Restituisce un codice di stato che indica l'esito positivo o negativo della funzione.

I codici restituiti possibili includono, ma non solo, quanto segue.

Osservazioni

Per combinare più buffer nell'hash o nel MAC, è possibile chiamare questa funzione più volte, passando un buffer diverso ogni volta. Per ottenere il valore hash o MAC, chiamare la funzione BCryptFinishHash . Dopo che la funzione BCryptFinishHash è stata chiamata per un handle specificato, tale handle non può essere riutilizzato.

A seconda delle modalità del processore supportate da un provider, è possibile chiamare BCryptHashData dalla modalità utente o dal kernel. I chiamanti in modalità kernel possono essere eseguiti in PASSIVE_LEVELirQL o DISPATCH_LEVEL IRQL. Se il livello IRQL corrente è DISPATCH_LEVEL, l'handle fornito nel parametro hHash deve essere derivato da un handle di algoritmo restituito da un provider aperto usando il flag BCRYPT_PROV_DISPATCH e tutti i puntatori passati alla funzione BCryptHashData devono fare riferimento a memoria non di pagina (o bloccata).

Per chiamare questa funzione in modalità kernel, usare Cng.lib, che fa parte del Driver Development Kit (DDK). Windows Server 2008 e Windows Vista: Per chiamare questa funzione in modalità kernel, usare Ksecdd.lib.

Fabbisogno

Vedere anche

BCryptCreateHash

BCryptFinishHash