Функция RtlWriteRegistryValue (wdm.h)

Статья
08/08/2023

Подпрограмма RtlWriteRegistryValue записывает данные, предоставленные вызывающим объектом, в реестр по указанному относительному пути по заданному имени значения.

Синтаксис

NTSYSAPI NTSTATUS RtlWriteRegistryValue(
  [in]           ULONG  RelativeTo,
  [in]           PCWSTR Path,
  [in]           PCWSTR ValueName,
  [in]           ULONG  ValueType,
  [in, optional] PVOID  ValueData,
  [in]           ULONG  ValueLength
);

Параметры

[in] RelativeTo

Указывает, является ли Path абсолютным путем реестра или относительно предопределенного пути в качестве одного из следующих значений.

Значение	Значение
RTL_REGISTRY_ABSOLUTE	Путь — это абсолютный путь к реестру.
RTL_REGISTRY_SERVICES	Путь относительно \Registry\Machine\System\CurrentControlSet\Services.
RTL_REGISTRY_CONTROL	Путь относительно \Registry\Machine\System\CurrentControlSet\Control.
RTL_REGISTRY_WINDOWS_NT	Путь относительно \Registry\Machine\Software\Microsoft\Windows NT\CurrentVersion.
RTL_REGISTRY_DEVICEMAP	Путь относительно \Registry\Machine\Hardware\DeviceMap.
RTL_REGISTRY_USER	Путь относительно \Registry\User\CurrentUser. (Для системного процесса это \Users\. По умолчанию.)
RTL_REGISTRY_OPTIONAL	Указывает, что ключ, на который ссылается этот параметр, и параметр Path являются необязательными.
RTL_REGISTRY_HANDLE	Указывает, что параметр Path фактически является дескриптором реестра для использования. Это необязательное значение.

[in] Path

Указатель на абсолютный путь к реестру или путь относительно известного расположения, указанного параметром RelativeTo . Если указан флаг RTL_REGISTRY_HANDLE, этот параметр является дескриптором реестра для уже открытого ключа, который будет использоваться напрямую.

[in] ValueName

Указатель на имя подраздела или записи значения, записываемой в реестр.

[in] ValueType

Задает значение REG_XXX , определяющее тип параметра ValueName . Список возможных значений см. в параметре Typeобъекта ZwSetValueKey.

[in, optional] ValueData

Указатель на имя подраздела или значения для его записей значений (или и того, и другого), записываемого в реестр.

[in] ValueLength

Указывает количество байтов ValueData для записи в реестр.

Возвращаемое значение

RtlWriteRegistryValue возвращает состояние операции STATUS_SUCCESS или состояние ошибки.

Если указанный ключ не существует, подпрограмма пытается создать ключ. Для успешной попытки новый ключ должен быть прямым подразделом ключа, на который ссылается параметр Path , а ключ, на который ссылается Path , должен быть открыт для KEY_CREATE_SUB_KEY доступа.

Требования

Требование	Значение
Минимальная версия клиента	Доступно начиная с Windows 2000.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL