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。
範例
如需如何使用此方法的範例,請參閱 從持續性唯一識別碼擷取物件識別碼
規格需求
需求 | 值 |
---|---|
標頭 |
|
程式庫 |
|