IWDFNamedPropertyStore::SetNamedValue method (wudfddi.h)

[Warning: UMDF 2 is the latest version of UMDF and supersedes UMDF 1. All new UMDF drivers should be written using UMDF 2. No new features are being added to UMDF 1 and there is limited support for UMDF 1 on newer versions of Windows 10. Universal Windows drivers must use UMDF 2. For more info, see Getting Started with UMDF.]

The SetNamedValue method sets the value of a property.

Syntax

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

Parameters

[in] pszName

A pointer to a null-terminated string that contains the name of the property.

[in] pv

A pointer to the value that the property is set to.

Return value

SetNamedValue returns S_OK if the operation succeeds. Otherwise, this method returns one of the error codes that are defined in Winerror.h.

Remarks

The following variant types are supported for property values. The following table shows the types of values that the framework writes for particular variant types.

Variant type Write
VT_BSTR Writes a string value.
VT_LPWSTR
VT_LPSTR
VT_I1 Writes an integer value.
VT_UI1
VT_I2
VT_UI2
VT_I4
VT_UI4
VT_UINT
VT_BLOB Writes a binary value.
VT_VECTOR | VT_LPWSTR Writes a string array.
 

For more information, see Using the Registry in UMDF-based Drivers.

Requirements

Requirement Value
End of support Unavailable in UMDF 2.0 and later.
Target Platform Desktop
Minimum UMDF version 1.5
Header wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

See also

IWDFNamedPropertyStore