Función RtlDeleteRegistryValue (wdm.h)
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) |