共用方式為


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 介面

在裝置上移動內容

從持續性唯一識別碼擷取物件識別碼