IPortableDeviceValues::GetValue 方法

GetValue 方法检索由键指定的 PROPVARIANT 值。

语法

HRESULT GetValue(
  [in]  REFPROPERTYKEY key,
  [out] PROPVARIANT    *pValue
);

参数

key [in]

指定要检索的项的 REFPROPERTYKEY 键。

pValue [out]

指向检索到的 PROPVARIANT 值的指针。 调用方在使用完内存后,必须通过调用 PropVariantClear 来释放内存。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
HRESULT_FROM_WIN32 (ERROR_NOT_FOUND)
由 key 指定的属性不在集合中。

备注

pValue 的 VARTYPE VT_VECTOR或VT_UI1时,不支持检索 NULL 或零大小的缓冲区。 例如,不允许 pValue.caub.pElems = NULL 或 pValue.caub.cElems = 0。

此方法可用于从集合中检索任何类型的值。 但是,如果事先知道值类型,请使用此接口的一种专用检索方法,以避免直接使用 PROPVARIANT 值的开销。

要求

要求 Value
标头
PortableDeviceTypes.h

PortableDeviceGUIDs.lib

另请参阅

IPortableDeviceValues 接口

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue