Freigeben über


IRegistryKey::D eleteKey-Methode (portcls.h)

Die DeleteKey -Methode löscht den Registrierungsschlüssel.

Syntax

NTSTATUS DeleteKey();

Rückgabewert

DeleteKey gibt STATUS_SUCCESS zurück, wenn der Aufruf erfolgreich war. Andernfalls gibt die Methode einen geeigneten Fehlercode zurück.

Hinweise

Ein Aufrufer löscht den Registrierungsschlüssel eines IRegistryKey-Objekts , indem er die DeleteKey -Methode für dieses Objekt aufruft. Der Schlüssel kann nur gelöscht werden, wenn der Aufrufer den Schlüssel mit einer ACCESS_MASK erstellt hat, die das Löschen zulässt. Der Aufrufer ermöglicht das Löschen, indem er den DesiredAccess-Parameterwert KEY_ALL_ACCESS (beschrieben in ZwCreateKey) für den PcNewRegistryKey-, IPort::NewRegistryKey- oder IRegistryKey::NewSubKey-Aufruf angibt, der den Schlüssel erstellt. Beim Löschen eines Schlüssels verwirft das IRegistryKey-Objekt sein Registrierungsschlüsselhandle, und alle anderen Handles für den gelöschten Schlüssel werden ungültig.

Anforderungen

Anforderung Wert
Zielplattform Universell
Header portcls.h (portcls.h einschließen)
IRQL PASSIVE_LEVEL

Weitere Informationen

ACCESS_MASK

IPort::NewRegistryKey

IRegistryKey

IRegistryKey::NewSubKey

PcNewRegistryKey

ZwCreateKey

ZwDeleteKey