Функция WdfRegistryAssignValue (wdfregistry.h)

Статья
02/27/2024

[Относится к KMDF и UMDF]

Метод WdfRegistryAssignValue назначает указанные данные указанному имени значения в реестре.

Синтаксис

NTSTATUS WdfRegistryAssignValue(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] ULONG            ValueType,
  [in] ULONG            ValueLength,
  [in] PVOID            Value
);

Параметры

[in] Key

Дескриптор для объекта раздела реестра, представляющего открытый раздел реестра.

[in] ValueName

Указатель на структуру UNICODE_STRING , содержащую имя значения.

[in] ValueType

Значение типа , определяющее тип данных. Список значений типов данных см. в элементе TypeKEY_VALUE_BASIC_INFORMATION.

[in] ValueLength

Длина (в байтах) буфера, на который указывает Значение .

[in] Value

Указатель на буфер, содержащий данные, предоставленные драйвером.

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

WdfRegistryAssignValue возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае метод может вернуть одно из следующих значений:

Код возврата	Описание
STATUS_INVALID_DEVICE_REQUEST	WdfRegistryAssignValue не был вызван в irQL = PASSIVE_LEVEL.
STATUS_INVALID_PARAMETER	Указан недопустимый параметр.
STATUS_ACCESS_DENIED	Драйвер не открыл раздел реестра с KEY_SET_VALUE доступом.

Этот метод также может возвращать другие значения NTSTATUS.

Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.

ULONG val;
NTSTATUS status;

val = 0x123456;
status = WdfRegistryAssignValue(
                                Key,
                                &valueName,
                                REG_BINARY,
                                sizeof(val),
                                &val
                                );

Требования

Требование	Значение
Целевая платформа	Универсальное
Минимальная версия KMDF	1,0
Минимальная версия UMDF	2,0
Верхняя часть	wdfregistry.h (включая Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)