Funzione ZwDeleteKey (wdm.h)
La routine ZwDeleteKey elimina una chiave aperta dal Registro di sistema.
Sintassi
NTSYSAPI NTSTATUS ZwDeleteKey(
[in] HANDLE KeyHandle
);
Parametri
[in] KeyHandle
Gestire la chiave del Registro di sistema da eliminare. L'handle viene creato da una chiamata riuscita a ZwCreateKey o ZwOpenKey.
Valore restituito
ZwDeleteKey restituisce un valore NTSTATUS. I valori restituiti possibili includono:
STATUS_SUCCESS
STATUS_ACCESS_DENIED
STATUS_INVALID_HANDLE
STATUS_CANNOT_DELETE (vedere la sezione Osservazioni)
Commenti
Prima di chiamare ZwDeleteKey, assicurarsi che tutte le chiavi e i valori nella chiave specificata siano stati eliminati. Eliminare prima ogni sottochiave, a partire dalle chiavi foglia e procedere in alto.
L'handle deve essere stato aperto affinché l'accesso DELETE abbia esito positivo per questa routine. Per altre informazioni, vedere il parametro DesiredAccess per ZwCreateKey.
Una chiamata a ZwDeleteKey fa sì che l'handle specificato nel parametro KeyHandle e tutti gli altri handle della chiave eliminata diventino non validi. Dopo una chiamata a ZwDeleteKey invalida gli handle di chiave, è necessario chiamare ZwClose per chiudere gli handle di chiave.
Per altre informazioni sull'uso delle chiavi del Registro di sistema, vedere Uso del Registro di sistema in un driver.
Se la chiamata a questa funzione viene eseguita in modalità utente, è necessario usare il nome "NtDeleteKey" anziché "ZwDeleteKey".
Per le chiamate da driver in modalità kernel, le versioni NtXxx e ZwXxx di una routine di Servizi di sistema nativi di Windows possono comportarsi in modo diverso nel modo in cui gestiscono e interpretano i parametri di input. Per altre informazioni sulla relazione tra le versioni NtXxx e ZwXxx di una routine, vedere Using Nt and Zw Versions of the Native System Services Routines .For more information about the Nt Xxx and Zw versions of the Native System Services Routines.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDDIs(storport), IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm) |
Vedi anche
Uso delle versioni Nt e Zw delle routine native di Servizi di sistema