IPortableDevicePropVariantCollection::Add 方法

Add 方法将项添加到集合中。

语法

HRESULT Add(
  [in] const PROPVARIANT *pValue
);

参数

pValue [in]

指向要添加到集合的新 PROPVARIANT 对象的指针。 此方法将 PROPVARIANT 复制到集合,因此应在调用此方法后通过调用 PropVariantClear 释放变量的本地副本。

返回值

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

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

备注

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

如果调用方尝试添加集合中包含的不同 VARTYPE 的项,并且此接口无法自动更改 PROPVARIANT 值,则此方法将失败。 若要手动更改集合类型,请调用 IPortableDevicePropVariantCollection::ChangeType

示例

有关如何使用此方法的示例,请参阅 从持久唯一标识符检索对象标识符

要求

要求
标头
PortableDeviceTypes.h

PortableDeviceGUIDs.lib

另请参阅

IPortableDevicePropVariantCollection 接口

在设备上移动内容

从持久唯一标识符检索对象标识符