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