IPortableDeviceValues::GetBufferValue 方法

GetBufferValue 方法检索 (类型VT_VECTOR的字节数组值 |VT_UI1) 由键指定。

语法

HRESULT GetBufferValue(
  [in]  REFPROPERTYKEY key,
  [out] BYTE           **ppValue,
  [out] DWORD          *pcbValue
);

参数

key [in]

指定要检索的项的 REFPROPERTYKEY 键。

ppValue [out]

指向检索的 BYTE* 值的指针。 调用方负责通过调用 CoTaskMemFree 来释放内存。

右值 [out]

指向 ppValue 大小的指针(以字节为单位)。

返回值

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

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

备注

不支持检索 NULL 缓冲区或零大小的缓冲区。

要求

要求
标头
PortableDeviceTypes.h

PortableDeviceGUIDs.lib

另请参阅

IPortableDeviceValues 接口

IPortableDeviceValues::SetBufferValue