ZwDeleteKey-Funktion (wdm.h)

  • Artikel

Die ZwDeleteKey-Routine löscht einen geöffneten Schlüssel aus der Registrierung.

Syntax

NTSYSAPI NTSTATUS ZwDeleteKey(
  [in] HANDLE KeyHandle
);

Parameter

[in] KeyHandle

Handle mit dem zu löschenden Registrierungsschlüssel. Das Handle wird durch einen erfolgreichen Aufruf von ZwCreateKey oder ZwOpenKey erstellt.

Rückgabewert

ZwDeleteKey gibt einen NTSTATUS-Wert zurück. Mögliche Rückgabewerte sind:

  • STATUS_SUCCESS

  • STATUS_ACCESS_DENIED

  • STATUS_INVALID_HANDLE

  • STATUS_CANNOT_DELETE (siehe Hinweise)

Hinweise

Stellen Sie vor dem Aufrufen von ZwDeleteKey sicher, dass alle Schlüssel und Werte unter dem angegebenen Schlüssel gelöscht wurden. Löschen Sie zuerst jeden Unterschlüssel, beginnend mit den Blattschlüsseln, und arbeiten Sie sich nach oben.

Das Handle muss für den DELETE-Zugriff geöffnet worden sein, damit diese Routine erfolgreich ist. Weitere Informationen finden Sie im DesiredAccess-Parameter für ZwCreateKey.

Ein Aufruf von ZwDeleteKey bewirkt, dass das im KeyHandle-Parameter angegebene Handle – und alle anderen Handles für den gelöschten Schlüssel – ungültig werden. Nachdem durch einen Aufruf von ZwDeleteKey die Schlüsselhandles ungültig wurden, müssen Sie ZwClose aufrufen, um die Schlüsselhandles zu schließen.

Weitere Informationen zum Arbeiten mit Registrierungsschlüsseln finden Sie unter Verwenden der Registrierung in einem Treiber.

Wenn der Aufruf dieser Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtDeleteKey" anstelle von "ZwDeleteKey" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs(storport), IrqlZwPassive(wdm), PowerIrpDDis(wdm), ZwRegistryCreate(storport), ZwRegistryCreate(storport), ZwRegistryCreate(wdm), ZwRegistryOpen(storport), ZwRegistryOpen(storport), ZwRegistryOpen(wdm)

Weitere Informationen

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateKey

ZwOpenKey