IPortableDeviceValues::SetBufferValue 方法 (portabledevicetypes.h)

将新的 BYTE* 值 (类型VT_VECTOR或VT_UI1) 或覆盖现有值。

语法

HRESULT SetBufferValue(
  [in] REFPROPERTYKEY key,
  [in] BYTE           *pValue,
  [in] DWORD          cbValue
);

参数

[in] key

一个 REFPROPERTYKEY ,指定要创建或覆盖的项。

[in] pValue

指向 BYTE 的指针,该 BYTE 包含要写入项的数据。 提交的缓冲区数据将复制到 接口,因此调用方可以在发出此调用后释放此缓冲区。

[in] cbValue

pValue 指向的值的大小(以字节为单位)。

返回值

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

返回代码 说明
S_OK
方法成功。

注解

不支持设置 NULL 或零大小的缓冲区。

如果现有值具有 由 key 参数指定的相同键,则它会覆盖现有值,而不会发出任何警告。 将适当释放现有密钥内存。

要求

要求
目标平台 Windows
标头 portabledevicetypes.h

另请参阅

IPortableDeviceValues 接口

IPortableDeviceValues::GetBufferValue