Funzione BCryptDestroySecret (bcrypt.h)
La funzione BCryptDestroySecret elimina definitivamente un handle del contratto segreto creato usando la funzione BCryptSecretAgreement.
Sintassi
NTSTATUS BCryptDestroySecret(
[in] BCRYPT_SECRET_HANDLE hSecret
);
Parametri
[in] hSecret
Il BCRYPT_SECRET_HANDLE da distruggere.
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 |
|---|---|
|
La funzione ha avuto esito positivo. |
|
L'handle nel parametro hSecret non è valido. |
Osservazioni
A seconda delle modalità del processore supportate da un provider, BCryptDestroySecret può essere chiamato 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 hSecret deve essere derivato da un handle di algoritmo restituito da un provider aperto usando il flag 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.
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 |