Функция WdfRegistryAssignValue (wdfregistry.h)
[Относится к 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, если операция выполнена успешно. В противном случае метод может вернуть одно из следующих значений:
| Код возврата | Описание |
|---|---|
|
WdfRegistryAssignValue не был вызван в irQL = PASSIVE_LEVEL. |
|
Указан недопустимый параметр. |
|
Драйвер не открыл раздел реестра с KEY_SET_VALUE доступом. |
Этот метод также может возвращать другие значения NTSTATUS.
Ошибка проверка возникает, если драйвер предоставляет недопустимый дескриптор объекта.
Комментарии
Если имя значения, указанное параметром ValueName , уже существует, WdfRegistryAssignValue обновляет данные значения.
Дополнительные сведения об объектах раздела реестра см. в статье Использование реестра в Framework-Based Drivers.
Примеры
В следующем примере кода шестнадцатеричное 123456 назначается значению реестра в виде двоичных данных.
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) |