Compartir a través de


Función RtlCreateRegistryKey (wdm.h)

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

Consulte también

RtlCheckRegistryKey

RtlDeleteRegistryValue

RtlQueryRegistryValues

RtlWriteRegistryValue

ZwEnumerateKey

ZwOpenKey