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)

Vedi anche

RtlCheckRegistryKey

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey