Funzione RtlDeleteRegistryValue (wdm.h)
La routine RtlDeleteRegistryValue rimuove il nome della voce e i valori associati dal Registro di sistema lungo il percorso relativo specificato.
Sintassi
NTSYSAPI NTSTATUS RtlDeleteRegistryValue(
[in] ULONG RelativeTo,
[in] PCWSTR Path,
[in] PCWSTR ValueName
);
Parametri
[in] RelativeTo
Specifica se Path è un percorso assoluto del Registro di sistema o è relativo a un percorso di chiave predefinito come uno dei seguenti.
| Valore | Significato |
|---|---|
| RTL_REGISTRY_ABSOLUTE | Path è un percorso assoluto del Registro di sistema. |
| RTL_REGISTRY_SERVICES | Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Services. |
| RTL_REGISTRY_CONTROL | Il percorso è relativo a \Registry\Machine\System\CurrentControlSet\Control. |
| RTL_REGISTRY_WINDOWS_NT | Il percorso è relativo a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion. |
| RTL_REGISTRY_DEVICEMAP | Il percorso è relativo a \Registry\Machine\Hardware\DeviceMap. |
| RTL_REGISTRY_USER | Il percorso è relativo a \Registry\User\CurrentUser. Per un processo di sistema, si tratta di \Users\. Impostazione predefinita. |
| RTL_REGISTRY_HANDLE | Specifica che il parametro Path è effettivamente un handle del Registro di sistema da utilizzare. Questo valore è facoltativo. |
[in] Path
Specifica il percorso del Registro di sistema in base al valore RelativeTo . Se RTL_REGISTRY_HANDLE è impostato, Path è un handle da usare direttamente.
[in] ValueName
Puntatore al nome del valore da rimuovere dal Registro di sistema.
Valore restituito
RtlDeleteRegistryValue restituisce STATUS_SUCCESS se la voce del valore è stata eliminata.
Si noti che se RelativeTo è impostato su RTL_REGISTRY_HANDLE, si verifica quanto segue:
- In Windows 98/Me e Windows NT 4.0 la routine chiude l'handle specificato prima di restituire.
- In Windows 2000 e versioni successive di Windows la routine lascia aperta l'handle.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 2000. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport), IrqlRtlPassive(wdm) |