Función RtlCreateRegistryKey (wdm.h)

Artículo
08/08/2023

La rutina RtlCreateRegistryKey agrega un objeto de clave en el Registro a lo largo de una ruta de acceso relativa determinada.

Sintaxis

NTSYSAPI NTSTATUS RtlCreateRegistryKey(
  [in] ULONG RelativeTo,
  [in] PWSTR Path
);

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	La ruta de acceso 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).

[in] Path

Especifica la ruta de acceso del Registro según el valor RelativeTo .

Valor devuelto

RtlCreateRegistryKey devuelve STATUS_SUCCESS si se crea la clave.

Comentarios

RtlCreateRegistryKey crea solo las claves que especifique. No crea claves que faltan en la ruta de acceso a la clave especificada. Si faltan claves en la ruta de acceso, se producirá un error en la llamada. Para asegurarse de que todas las claves de la ruta de acceso existen, debe llamar a RtlCreateRegistryKey una vez para cada clave de la ruta de acceso.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows 2000 y versiones posteriores de Windows.
Plataforma de destino	Universal
Encabezado	wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h)
Library	NtosKrnl.lib
Archivo DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL