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 | 所有级别 |