IWDFNamedPropertyStore：：GetNamedValue 方法 (wudfddi.h)
[警告： UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。]
GetNamedValue 方法检索属性的值。
语法
HRESULT GetNamedValue(
[in] LPCWSTR pszName,
[out] PROPVARIANT *pv
);
参数
[in] pszName
指向包含属性名称的以 null 结尾的字符串的指针。
[out] pv
指向接收属性值的变量的指针。
返回值
如果操作成功，GetNamedValue 将返回S_OK。 否则，此方法返回 Winerror.h 中定义的错误代码之一。
注解
GetNamedValue 方法为 pv 参数指向的 PROPVARIANT 结构中的字符串分配内存。 然后，调用方必须通过调用 PropVariantClear 函数来释放此内存，如以下代码片段所示：
hr = pPropStore->GetNamedValue(L"Host", &val);
...
PropVariantClear(&val);如果调用方不释放内存，可能会导致内存泄漏。
属性值支持以下变体类型。 下表显示了返回的变体类型，而不考虑原始变体类型。
| Variant 类型 | 检索到的变体类型 |
|---|---|
| VT_BSTR | 当客户端读取字符串值时，该值将作为VT_LPWSTR返回，而不考虑用于写入该值的原始变体类型。 |
| VT_LPWSTR | |
| VT_LPSTR | |
| VT_I1 | 当客户端读取整数值时，该值将作为VT_UI4返回，而不考虑用于写入该值的原始变体类型。 |
| VT_UI1 | |
| VT_I2 | |
| VT_UI2 | |
| VT_I4 | |
| VT_UI4 | |
| VT_UINT | |
| VT_BLOB | 二进制值作为VT_BLOB返回。 |
| VT_VECTOR |VT_LPWSTR | 字符串数组作为VT_VECTOR返回 |VT_LPWSTR |
包含环境变量的字符串在读取时展开。
有关详细信息，请参阅 在基于 UMDF 的驱动程序中使用注册表。
要求
| 要求 | 值 |
|---|---|
| 结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
| 目标平台 | 桌面 |
| 最低 UMDF 版本 | 1.5 |
| 标头 | wudfddi.h (包括 Wudfddi.h) |
| DLL | WUDFx.dll |