Funzione BCryptDestroyHash (bcrypt.h)

La funzione BCryptDestroyHash elimina un oggetto hash o Message Authentication Code (MAC).

Sintassi

NTSTATUS BCryptDestroyHash(
  [in, out] BCRYPT_HASH_HANDLE hHash
);

Parametri

[in, out] hHash

Handle dell'oggetto hash o MAC da eliminare. Questo handle viene ottenuto usando la funzione BCryptCreateHash .

Valore restituito

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

I codici restituiti possibili includono, ma non sono limitati a, i seguenti.

Commenti

A seconda delle modalità di processore supportate da un provider, è possibile chiamare BCryptDestroyHash dalla modalità utente o dalla modalità 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 di BCRYPT_PROV_DISPATCH .

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.

Requisiti

Vedi anche

BCryptCreateHash