Функция RtlWriteRegistryValue (wdm.h)
Подпрограмма 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 |