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

另请参阅

IWDFNamedPropertyStore

PROPVARIANT

PropVariantClear