IPortableDevicePropVariantCollection::Add 方法 (portabledevicetypes.h)

向集合中添加一项。

语法

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

参数

[in] pValue

指向要添加到集合的新 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

要求

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

另请参阅

IPortableDevicePropVariantCollection 接口