RtlDeleteRegistryValue-Funktion (wdm.h)

  • Artikel

Die RtlDeleteRegistryValue-Routine entfernt den angegebenen Eintragsnamen und die zugeordneten Werte aus der Registrierung entlang des angegebenen relativen Pfads.

Syntax

NTSYSAPI NTSTATUS RtlDeleteRegistryValue(
  [in] ULONG  RelativeTo,
  [in] PCWSTR Path,
  [in] PCWSTR ValueName
);

Parameter

[in] RelativeTo

Gibt an, ob Path ein absoluter Registrierungspfad oder relativ zu einem vordefinierten Schlüsselpfad ist.

Wert Bedeutung
RTL_REGISTRY_ABSOLUTE Path ist ein absoluter Registrierungspfad.
RTL_REGISTRY_SERVICES Der Pfad ist relativ zu \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL Pfad ist relativ zu \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT Der Pfad ist relativ zu \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP Der Pfad ist relativ zu \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER Der Pfad ist relativ zu \Registry\User\CurrentUser. (Für einen Systemprozess ist dies \Users\. Standard.)
RTL_REGISTRY_HANDLE Gibt an, dass der Path-Parameter tatsächlich ein zu verwendende Registrierungshandle ist. Dieser Wert ist optional.

[in] Path

Gibt den Registrierungspfad gemäß dem RelativeTo-Wert an. Wenn RTL_REGISTRY_HANDLE festgelegt ist, ist Path ein Handle, das direkt verwendet werden soll.

[in] ValueName

Zeiger auf den Wertnamen, der aus der Registrierung entfernt werden soll.

Rückgabewert

RtlDeleteRegistryValue gibt STATUS_SUCCESS zurück, wenn der Werteintrag gelöscht wurde.

Beachten Sie, dass Folgendes auftritt, wenn RelativeTo auf RTL_REGISTRY_HANDLE festgelegt ist:

  • Unter Windows 98/Me und Windows NT 4.0 schließt die Routine das angegebene Handle vor der Rückgabe.
  • Unter Windows 2000 und höheren Versionen von Windows lässt die Routine das Handle geöffnet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar ab Windows 2000.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDDIs(storport), IrqlRtlPassive(wdm)

Weitere Informationen

RtlCheckRegistryKey

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey