IPortableDevicePropVariantCollection::Add 方法
Add 方法将项添加到集合中。
语法
HRESULT Add(
[in] const PROPVARIANT *pValue
);
参数
-
pValue [in]
-
指向要添加到集合的新 PROPVARIANT 对象的指针。 此方法将 PROPVARIANT 复制到集合,因此应在调用此方法后通过调用 PropVariantClear 释放变量的本地副本。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
备注
当 pValue 的 VARTYPE VT_VECTOR或VT_UI1时,不支持设置和检索 NULL 或零大小的缓冲区。 例如,不允许 pValue.caub.pElems = NULL 或 pValue.caub.cElems = 0。
如果调用方尝试添加集合中包含的不同 VARTYPE 的项,并且此接口无法自动更改 PROPVARIANT 值,则此方法将失败。 若要手动更改集合类型,请调用 IPortableDevicePropVariantCollection::ChangeType。
示例
有关如何使用此方法的示例,请参阅 从持久唯一标识符检索对象标识符
要求
要求 | 值 |
---|---|
标头 |
|
库 |
|