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 |