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

Статья
03/22/2025

[Применимо к KMDF и UMDF]

Метод WdfRegistryAssignUnicodeString назначает указанную строку Юникода указанному имени значения в реестре.

Синтаксис

NTSTATUS WdfRegistryAssignUnicodeString(
  [in] WDFKEY           Key,
  [in] PCUNICODE_STRING ValueName,
  [in] PCUNICODE_STRING Value
);

Параметры

[in] Key

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

[in] ValueName

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

[in] Value

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

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

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

Код возврата	Описание
STATUS_INVALID_DEVICE_REQUEST	WdfRegistryAssignUnicodeString не был вызван в IRQL = PASSIVE_LEVEL.
СТАТУС_НЕДЕЙСТВИТЕЛЬНЫЙ_ПАРАМЕТР	Указан недопустимый параметр.
STATUS_ACCESS_DENIED	Драйвер не открыл раздел реестра с KEY_SET_VALUE доступом.
СТАТУС_НЕДОСТАТОЧНЫЕ_РЕСУРСЫ	Для завершения операции недостаточно памяти.

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

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

Замечания

Если строка, указанная параметром значением, не завершается значение NULL, платформа добавляет символ NULL при копировании строки в реестр.

Если имя значения, указанное параметром valueName , уже существует, WdfRegistryAssignUnicodeString обновляет данные значения.

Платформа задает тип данных значения для REG_SZ.

Дополнительные сведения о объектах раздела реестра см. в разделе Использование реестра в Framework-Based драйверах.

Примеры

В следующем примере кода строка Юникода "String1" назначается значению ValueName в указанном разделе реестра.

UNICODE_STRING ustring1, valueName;
NTSTATUS status;

RtlInitUnicodeString(
                     &ustring1,
                     L"String1"
                     );
RtlInitUnicodeString(
                     &valueName,
                     L"ValueName"
                     );

status = WdfRegistryAssignUnicodeString(
                                        Key,
                                        &valueName,
                                        &string1
                                        );

Требования

Требование	Ценность
целевая платформа	универсальный
минимальная версия KMDF	1.0
минимальная версия UMDF	2.0
Заголовок	wdfregistry.h (include Wdf.h)
Библиотека	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	PASSIVE_LEVEL
правил соответствия DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)