IPropertyStore::GetValue 方法 (propsys.h)

此方法检索特定属性的数据。

语法

HRESULT GetValue(
  REFPROPERTYKEY key,
  PROPVARIANT    *pv
);

参数

key

TBD

pv

方法 IPropertyStore::GetValue 成功返回后,此参数指向包含有关 属性的数据的 PROPVARIANT 结构。

返回值

如果成功,则返回S_OK或INPLACE_S_TRUNCATED,否则返回错误值。

返回INPLACE_S_TRUNCATED指示返回的 PROPVARIANT 已转换为更规范的形式。 例如,这样做是为了剪裁字符串值中的前导空格或尾随空格。 必须使用 SUCCEEDED 宏检查返回值,这将INPLACE_S_TRUNCATED视为成功代码。 SUCCEEDED 宏在 Winerror.h 文件中定义。

注解

如果键中引用的 PROPERTYKEY 在属性存储中不存在,则此方法返回S_OK,并且 pv 指向的结构的 vt 成员设置为 VT_EMPTY。

要求

要求
最低受支持的客户端 适用于 Windows Vista 和更高版本的 Windows 操作系统。
目标平台 通用
标头 propsys.h
Library Propsys.idl
IRQL 所有级别

另请参阅

IPropertyStore

IPropertyStore::GetAt