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 |