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

Artikel
02/26/2024

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.