Funzione ZwDeleteKey (wdm.h)

  • Articolo

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

ZwCreateKey

ZwOpenKey