ZwDeleteKey-Funktion (wdm.h)
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) |