Funzione BCryptHashData (bcrypt.h)

Articolo
07/16/2024

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.

Codice restituito	Descrizione
STATUS_SUCCESS	La funzione ha avuto esito positivo.
STATUS_INVALID_PARAMETER	Uno o più parametri non sono validi.
STATUS_INVALID_HANDLE	L'handle hash nel parametro hHash non è valido. Dopo aver chiamato la funzione BCryptFinishHash per un handle hash, tale handle non può essere riutilizzato.

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

Requisito	Valore
client minimo supportato	Windows Vista [app desktop \| App UWP]
server minimo supportato	Windows Server 2008 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	bcrypt.h
libreria	Bcrypt.lib
dll	Bcrypt.dll

Vedere anche

BCryptCreateHash

BCryptFinishHash

Condividi tramite