IPortableDeviceValues::GetValue 方法 (portabledevicetypes.h)

GetValue 接口检索由键指定的 PROPVARIANT 值。

语法

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

参数

[in] key

一个 REFPROPERTYKEY 键,指定要检索的项。

[out] pValue

指向检索到 的 PROPVARIANT 值的指针。 调用方必须在调用完成后调用 PropVariantClear 释放内存。

返回值

该方法返回 HRESULT。 下表显示了可能的返回值。

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

备注

此方法可用于从集合中检索任何类型的值。 但是,如果事先知道值类型,请使用此接口的一种专用检索方法进行其他类型检查。

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

要求

   
目标平台 Windows
标头 portabledevicetypes.h

另请参阅

IPortableDeviceValues 接口

IPortableDeviceValues::RemoveValue

IPortableDeviceValues::SetValue