Метод IWDFNamedPropertyStore::SetNamedValue (wudfddi.h)

Статья
08/08/2023

[Предупреждение: UMDF 2 является последней версией UMDF и заменяет UMDF 1. Все новые драйверы UMDF должны быть написаны с помощью UMDF 2. Новые функции не добавляются в UMDF 1, а поддержка UMDF 1 в более новых версиях Windows 10 ограничена. Универсальные драйверы Windows должны использовать UMDF 2. Дополнительные сведения см. в разделе начало работы с помощью UMDF.]

Метод SetNamedValue задает значение свойства.

Синтаксис

HRESULT SetNamedValue(
  [in] LPCWSTR           pszName,
  [in] const PROPVARIANT *pv
);

Параметры

[in] pszName

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

[in] pv

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

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

SetNamedValue возвращает S_OK, если операция выполнена успешно. В противном случае этот метод возвращает один из кодов ошибок, определенных в Winerror.h.

Для значений свойств поддерживаются следующие типы вариантов. В следующей таблице показаны типы значений, которые платформа записывает для конкретных типов вариантов.

Тип Variant	Write
VT_BSTR	Записывает строковое значение.
VT_LPWSTR
VT_LPSTR
VT_I1	Записывает целочисленное значение.
VT_UI1
VT_I2
VT_UI2
VT_I4
VT_UI4
VT_UINT
VT_BLOB	Записывает двоичное значение.
VT_VECTOR \| VT_LPWSTR	Записывает массив строк.

Дополнительные сведения см. в разделе Использование реестра в драйверах на основе UMDF.

Требования

Требование	Значение
Дата окончания поддержки	Недоступно в UMDF 2.0 и более поздних версиях.
Целевая платформа	Персональный компьютер
Минимальная версия UMDF	1.5
Верхняя часть	wudfddi.h (включая Wudfddi.h)
DLL	WUDFx.dll

См. также раздел

IWDFNamedPropertyStore

Поделиться через