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 |