Función RtlDeleteRegistryValue (wdm.h)

  • Artículo

La rutina RtlDeleteRegistryValue quita el nombre de entrada especificado y los valores asociados del registro a lo largo de la ruta de acceso relativa especificada.

Sintaxis

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

Parámetros

[in] RelativeTo

Especifica si Path es una ruta de acceso absoluta del Registro o es relativa a una ruta de acceso de clave predefinida como una de las siguientes.

Valor Significado
RTL_REGISTRY_ABSOLUTE Path es una ruta de acceso absoluta del Registro.
RTL_REGISTRY_SERVICES La ruta de acceso es relativa a \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL La ruta de acceso es relativa a \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT La ruta de acceso es relativa a \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP La ruta de acceso es relativa a \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER La ruta de acceso es relativa a \Registry\User\CurrentUser. (Para un proceso del sistema, es \Users\. Valor predeterminado).
RTL_REGISTRY_HANDLE Especifica que el parámetro Path es realmente un identificador del Registro que se va a usar. Este valor es opcional.

[in] Path

Especifica la ruta de acceso del Registro según el valor RelativeTo . Si se establece RTL_REGISTRY_HANDLE, Path es un identificador que se usará directamente.

[in] ValueName

Puntero al nombre del valor que se va a quitar del Registro.

Valor devuelto

RtlDeleteRegistryValue devuelve STATUS_SUCCESS si se eliminó la entrada de valor.

Tenga en cuenta que si RelativeTo está establecido en RTL_REGISTRY_HANDLE, se produce lo siguiente:

  • En Windows 98/Me y Windows NT 4.0, la rutina cierra el identificador especificado antes de devolverlo.
  • En Windows 2000 y versiones posteriores de Windows, la rutina deja el identificador abierto.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 2000.
Plataforma de destino Universal
Encabezado wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
Archivo DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Reglas de cumplimiento de DDI HwStorPortProhibitedDIs(storport), IrqlRtlPassive(wdm)

Consulte también

RtlCheckRegistryKey

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey